KeosString.h

Go to the documentation of this file.

/*
 * This source file is part of KEOS (Free 3D Engine)
 * For the latest info, see http://www.keosengine.org/
 * E-mails : thierry.vouriot@keosengine.org, yeri@keosengine.org
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Lesser General Public License as published by the Free Software
 * Foundation; either version 2 of the License, or (at your option) any later
 * version.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 * Place - Suite 330, Boston, MA 02111-1307, USA, or go to
 * http://www.gnu.org/copyleft/lesser.txt.
 *
 */
#ifndef KEOS_STRING_H
#define KEOS_STRING_H

#include "KeosPrerequisites.h"

namespace Keos
{
  class KEOS_EXPORT CStringUtil
  {
  public:
    typedef std::stringstream StrStreamType;

    static void Split(const String& strString, std::vector<String>& Tokens, const String& strDelim = " \t\n");

    static void Trim( String& str, bool bLeft = true, bool bRight = true );

    static void ToLowerCase( String& str );

    static void ToUpperCase( String& str );

    static String ToLower(const String& strText);

    static String ToUpper(const String& strText);

    static const String BLANK;
  };

  class KEOS_EXPORT CStringConverter
  {
  public:

    static String ToString(float fVal, ushort nPrecision = 6,
                           ushort nWidth = 0, char fill = ' ',
                           std::ios::fmtflags flags = std::ios::fmtflags(0) );

    static String ToString(int nVal, unsigned short nWidth = 0,
                           char fill = ' ',
                           std::ios::fmtflags flags = std::ios::fmtflags(0) );

    static String ToString(bool bVal, bool bYesNo = false);

    static Real ParseReal(const String& strVal);

    static int ParseInt(const String& strVal);

    static uint ParseUnsignedInt(const String& strVal);

    static long ParseLong(const String& strVal);

    static ulong ParseUnsignedLong(const String& strVal);

    static bool ParseBool(const String& strVal);
  };

  class CStringBuilder
  {
  public :

    //----------------------------------------------------------------
    // Constructeur par défaut
    //----------------------------------------------------------------
    CStringBuilder();

    //----------------------------------------------------------------
    // Construit l'injecteur avec une première valeur
    //----------------------------------------------------------------
    template <typename T> CStringBuilder(const T& Value);

    //----------------------------------------------------------------
    // Injecte une valeur dans la chaîne
    //----------------------------------------------------------------
    template <typename T> CStringBuilder& operator ()(const T& Value);

    //----------------------------------------------------------------
    // Opérateur de conversion implicite en string
    //----------------------------------------------------------------
    operator std::string();

  private :

    //----------------------------------------------------------------
    // Données membres
    //----------------------------------------------------------------
    std::ostringstream m_OutStream; 
  };


  class CStringExtractor
  {
  public :

    //----------------------------------------------------------------
    // Construit l'extracteur à partir d'une chaîne
    //----------------------------------------------------------------
    CStringExtractor(const std::string& Text);

    //----------------------------------------------------------------
    // Extrait une valeur de type T
    //----------------------------------------------------------------
    template <typename T> CStringExtractor& operator ()(T& Value);

    //----------------------------------------------------------------
    // Vérifie qu'il n'y a plus rien à extraire
    //----------------------------------------------------------------
    void ThrowIfEOF();

  private :

    //----------------------------------------------------------------
    // Données membres
    //----------------------------------------------------------------
    std::istringstream m_InStream; 
  };

  template <typename T>
  inline CStringBuilder::CStringBuilder(const T& Value)
  {
    m_OutStream << Value;
  }


  template <typename T>
  inline CStringBuilder& CStringBuilder::operator ()(const T& Value)
  {
    m_OutStream << Value;

    return *this;
  }


  inline CStringBuilder::operator std::string()
  {
    return m_OutStream.str();
  }


  inline CStringExtractor::CStringExtractor(const std::string& Text) :
      m_InStream(Text)
  {}


  template <typename T>
  inline CStringExtractor& CStringExtractor::operator ()(T& Value)
  {
    if (!(m_InStream >> Value))
    {
      if (m_InStream.eof())
        throw CBadConversion(CStringBuilder("Tentative d'extraire un \"")(typeid(T).name())("\" à partir d'une chaîne vide"), "");
      else
        throw CBadConversion(CStringBuilder("Impossible de convertir de \"string\" en \"")(typeid(T).name())("\""), "");
    }

    return *this;
  }


  inline void CStringExtractor::ThrowIfEOF()
  {
    std::string Left;
    if (std::getline(m_InStream, Left))
      throw CBadConversion("Chaîne trop longue, \"" + Left + "\" n'a pas été extrait", "");
  }


} // namespace Keos

#endif // KEOS_STRING_H

---