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         /**
  40          * Convierte de un tipo a otro (de p1 a p2) a través de un stringstream.
  41          *
  42          * \param p1 Parámetro origen.
  43          * \param p2 Parámetro destino, al que se quiere convertir.
  44          *
  45          * \return Referencia a p2.
  46          */
  47         template < class T1, class T2 > static T2& to(const T1& p1, T2& p2) {
  48                 std::stringstream ss(p1);
  49                 ss << p1;
  50                 ss >> p2;
  51                 return p2;
  52         }
  53
  54         /// String con varios métodos útiles.
  55         class String: public std::string {
  56
  57                 /////////////////////////////////////////////////////////////////////
  58                 // Métodos.
  59
  60                 public:
  61
  62                         /// Caracteres que son considerados espacios a la hora de parsear.
  63                         static const std::string SPACE_CHARS;
  64
  65                         /**
  66                          * Destructor.
  67                          */
  68                         virtual ~String(void);
  69
  70                         /**
  71                          * Constructor.
  72                          */
  73                         String(void);
  74
  75                         /**
  76                          * Constructor.
  77                          *
  78                          * \param str String a copiar.
  79                          */
  80                         String(const std::string& str);
  81
  82                         /**
  83                          * Constructor a partir de un vector.
  84                          * Convierte el vector en string uniendo sus componentes a traves
  85                          * del separador.
  86                          *
  87                          * \param v   Vector.
  88                          * \param sep Separador.
  89                          */
  90                         String(const std::vector<std::string>& v,
  91                                         const std::string& sep);
  92
  93                         /**
  94                          * Elmina caracteres al inicio y fin de un string.
  95                          *
  96                          * \param clist Lista de caracteres a eliminar.
  97                          */
  98                         String& trim(const String& clist = SPACE_CHARS);
  99
 100                         /**
 101                          * Convierte a mayúsculas.
 102                          */
 103                         String& to_upper(void);
 104
 105                         /**
 106                          * Convierte a mayúsculas.
 107                          */
 108                         String& to_lower(void);
 109
 110                         /**
 111                          * Fracciona una cadena convirtiendola en un vector.
 112                          *
 113                          * \param sep Caracter usado como separador.
 114                          */
 115                         std::vector<std::string> split(char sep) const;
 116
 117                         /**
 118                          * Concatena los elementos de un vector.
 119                          *
 120                          * \param v   Vector.
 121                          * \param sep Separador.
 122                          */
 123                         static String join(const std::vector<std::string>& v,
 124                                         const std::string& sep);
 125
 126                         /**
 127                          * Convierte un string a otro tipo.
 128                          *
 129                          * \param p Parametro del tipo al que se quiere convertir.
 130                          */
 131                         template < class T > T& to(T& p) const {
 132                                 std::stringstream ss(*this);
 133                             ss >> p;
 134                             return p;
 135                         }
 136
 137                         /**
 138                          * Convierte un tipo a string.
 139                          *
 140                          * \param p Parametro del tipo que se quiere convertir a string.
 141                          */
 142                         template < class T > String& from(const T& p) {
 143                                 std::stringstream ss;
 144                             ss << p;
 145                             ss >> (*this);
 146                             return *this;
 147                         }
 148
 149         };
 150
 151 }
 152
 153 }
 154
 155 #endif // PLAQUI_STRING_H