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 <vector>
  33
  34 namespace PlaQui {
  35
  36 namespace Server {
  37
  38         /// Conexión.
  39         class String: public std::string {
  40
  41                 public:
  42
  43                         /// Caracteres que son considerados espacios a la hora de parsear.
  44                         static const std::string SPACE_CHARS;
  45
  46                         /**
  47                          * Destructor.
  48                          */
  49                         virtual ~String(void);
  50
  51                         /**
  52                          * Constructor.
  53                          *
  54                          * \param str String a copiar.
  55                          */
  56                         String(const std::string& str);
  57
  58                         /**
  59                          * Constructor a partir de un vector.
  60                          * Convierte el vector en string uniendo sus componentes a traves
  61                          * del separador.
  62                          *
  63                          * \param v   Vector.
  64                          * \param sep Separador.
  65                          */
  66                         String(const std::vector<std::string>& v,
  67                                         const std::string& sep);
  68
  69                         /**
  70                          * Elmina caracteres al inicio y fin de un string.
  71                          *
  72                          * \param c Lista de caracteres a eliminar.
  73                          */
  74                         String& trim(const String& clist = SPACE_CHARS);
  75
  76                         /**
  77                          * Convierte a mayúsculas.
  78                          */
  79                         String& to_upper(void);
  80
  81                         /**
  82                          * Convierte a mayúsculas.
  83                          */
  84                         String& to_lower(void);
  85
  86                         /**
  87                          * Fracciona una cadena convirtiendola en un vector.
  88                          *
  89                          * \param sep Caracter usado como separador.
  90                          */
  91                         std::vector<std::string> split(char sep) const;
  92
  93                         /**
  94                          * Concatena los elementos de un vector.
  95                          *
  96                          * \param v   Vector.
  97                          * \param sep Separador.
  98                          */
  99                         static String join(const std::vector<std::string>& v,
 100                                         const std::string& sep);
 101
 102         };
 103
 104 }
 105
 106 }
 107
 108 #endif // PLAQUI_STRING_H