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                         String(void);
  55
  56                         /**
  57                          * Constructor.
  58                          *
  59                          * \param str String a copiar.
  60                          */
  61                         String(const std::string& str);
  62
  63                         /**
  64                          * Constructor a partir de un vector.
  65                          * Convierte el vector en string uniendo sus componentes a traves
  66                          * del separador.
  67                          *
  68                          * \param v   Vector.
  69                          * \param sep Separador.
  70                          */
  71                         String(const std::vector<std::string>& v,
  72                                         const std::string& sep);
  73
  74                         /**
  75                          * Elmina caracteres al inicio y fin de un string.
  76                          *
  77                          * \param c Lista de caracteres a eliminar.
  78                          */
  79                         String& trim(const String& clist = SPACE_CHARS);
  80
  81                         /**
  82                          * Convierte a mayúsculas.
  83                          */
  84                         String& to_upper(void);
  85
  86                         /**
  87                          * Convierte a mayúsculas.
  88                          */
  89                         String& to_lower(void);
  90
  91                         /**
  92                          * Fracciona una cadena convirtiendola en un vector.
  93                          *
  94                          * \param sep Caracter usado como separador.
  95                          */
  96                         std::vector<std::string> split(char sep) const;
  97
  98                         /**
  99                          * Concatena los elementos de un vector.
 100                          *
 101                          * \param v   Vector.
 102                          * \param sep Separador.
 103                          */
 104                         static String join(const std::vector<std::string>& v,
 105                                         const std::string& sep);
 106
 107         };
 108
 109 }
 110
 111 }
 112
 113 #endif // PLAQUI_STRING_H