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