Server/include/plaqui/server/string.h

   1 // vim: set noexpandtab tabstop=4 shiftwidth=4:
   2 //----------------------------------------------------------------------------
   3 //                                  PlaQui
   4 //----------------------------------------------------------------------------
   5 // This file is part of PlaQui.
   6 //
   7 // PlaQui is free software; you can redistribute it and/or modify it under the
   8 // terms of the GNU General Public License as published by the Free Software
   9 // Foundation; either version 2 of the License, or (at your option) any later
  10 // version.
  11 //
  12 // PlaQui is distributed in the hope that it will be useful, but WITHOUT ANY
  13 // WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  14 // FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
  15 // details.
  16 //
  17 // You should have received a copy of the GNU General Public License along
  18 // with PlaQui; if not, write to the Free Software Foundation, Inc., 59 Temple
  19 // Place, Suite 330, Boston, MA  02111-1307  USA
  20 //----------------------------------------------------------------------------
  21 // Creado:  dom oct 19 16:46:00 ART 2003
  22 // Autores: Leandro Lucarella <llucare@fi.uba.ar>
  23 //----------------------------------------------------------------------------
  24 //
  25 // $Id$
  26 //
  27
  28 #ifndef PLAQUI_STRING_H
  29 #define PLAQUI_STRING_H
  30
  31 #include <string>
  32 #include <sstream>
  33 #include <vector>
  34
  35 namespace PlaQui {
  36
  37 namespace Server {
  38
  39         /// Conexión.
  40         class String: public std::string {
  41
  42                 public:
  43
  44                         /// Caracteres que son considerados espacios a la hora de parsear.
  45                         static const std::string SPACE_CHARS;
  46
  47                         /**
  48                          * Destructor.
  49                          */
  50                         virtual ~String(void);
  51
  52                         /**
  53                          * Constructor.
  54                          */
  55                         String(void);
  56
  57                         /**
  58                          * Constructor.
  59                          *
  60                          * \param str String a copiar.
  61                          */
  62                         String(const std::string& str);
  63
  64                         /**
  65                          * Constructor a partir de un vector.
  66                          * Convierte el vector en string uniendo sus componentes a traves
  67                          * del separador.
  68                          *
  69                          * \param v   Vector.
  70                          * \param sep Separador.
  71                          */
  72                         String(const std::vector<std::string>& v,
  73                                         const std::string& sep);
  74
  75                         /**
  76                          * Elmina caracteres al inicio y fin de un string.
  77                          *
  78                          * \param c Lista de caracteres a eliminar.
  79                          */
  80                         String& trim(const String& clist = SPACE_CHARS);
  81
  82                         /**
  83                          * Convierte a mayúsculas.
  84                          */
  85                         String& to_upper(void);
  86
  87                         /**
  88                          * Convierte a mayúsculas.
  89                          */
  90                         String& to_lower(void);
  91
  92                         /**
  93                          * Fracciona una cadena convirtiendola en un vector.
  94                          *
  95                          * \param sep Caracter usado como separador.
  96                          */
  97                         std::vector<std::string> split(char sep) const;
  98
  99                         /**
 100                          * Concatena los elementos de un vector.
 101                          *
 102                          * \param v   Vector.
 103                          * \param sep Separador.
 104                          */
 105                         static String join(const std::vector<std::string>& v,
 106                                         const std::string& sep);
 107
 108                         /**
 109                          * Convierte un string a otro tipo.
 110                          *
 111                          * \param p Parametro del tipo al que se quiere convertir.
 112                          */
 113                         template < class T > T& to(T& p) const {
 114                                 std::stringstream ss(*this);
 115                             ss >> p;
 116                             return p;
 117                         }
 118
 119                         /**
 120                          * Convierte un tipo a string.
 121                          *
 122                          * \param p Parametro del tipo que se quiere convertir a string.
 123                          */
 124                         template < class T > String& from(const T& p) {
 125                                 std::stringstream ss;
 126                             ss << p;
 127                             ss >> (*this);
 128                             return *this;
 129                         }
 130
 131         };
 132
 133 }
 134
 135 }
 136
 137 #endif // PLAQUI_STRING_H