StringUtils.h

Go to the documentation of this file.

#ifndef CARMA_UTIL_STRINGUTILS_H
#define CARMA_UTIL_STRINGUTILS_H

#include <string>
#include <set>
#include <vector>
#include <sstream>

namespace carma {
    namespace util {

    typedef enum {
        MD5,
        SHA1
    } DigestType;

     template <typename T> ::std::string vectorToString
         (const ::std::vector<T>& v, const ::std::string& delimiter=", ") {
         ::std::ostringstream os;
         int size = v.size();
         for(int i=0; i<size; i++) {
             os << v[i];
             if(i < size-1) {
                 os << delimiter;
             }
         }
         return os.str();
     }


     template <typename T> ::std::string setToString
         (const ::std::set<T>& s, const ::std::string& delimiter=", ") {
         ::std::ostringstream os;
         int size = s.size();
         typename ::std::set<T>::iterator iter;
         int count = 0;
         for(iter=s.begin(); iter != s.end(); iter++) {
             os << *iter;
             if(count < size-1) {
                 os << delimiter;
             }
             count++;
         }
         return os.str();
     }


class StringUtils {
public:

    typedef enum sortTypeEnum {
        ASCENDING_SORT,
        DESCENDING_SORT
    } sortType;


    StringUtils();

    virtual ~StringUtils();

    static ::std::string lowASCIIAlphaNumericToUpper(const ::std::string& str);

    static void toLower(::std::vector< ::std::string > & v);

    static void toUpper(::std::vector< ::std::string > & v);

    static ::std::string lowASCIIAlphaNumericToLower(const ::std::string& str);

    static ::std::string erase(const ::std::string& str,
                             const ::std::vector<char>& chars);

    static void trimInplace( ::std::string &       str,
                             const ::std::string & chars );

    static ::std::string trim( const ::std::string & str,
                               const ::std::string & chars );


    static void trimWhiteSpaceInplace( ::std::string & str );

    static ::std::string trimWhiteSpace( const ::std::string & str );


    static ::std::string collapse(const ::std::string& str,
                            const ::std::vector<char>& chars);

    static ::std::string collapse(const ::std::string& str, char c);

    static ::std::string replace(const ::std::string& str,
                               const ::std::string& origStr,
                               const ::std::string& replStr);

    static void
    tokenizeInplace( ::std::vector< ::std::string > & tokens,
                     const ::std::string &            str,
                     const ::std::string &            delimiterSet = " ",
                     bool                             skipNull = true );

    static ::std::vector< ::std::string >
    tokenize( const ::std::string & str,
              const ::std::string & delimiterSet = " ",
              bool                  skipNull = true );

    static void
    tokenizeNInplace( ::std::vector< ::std::string > & tokens,
                      const ::std::string &            str,
                      const size_t                     maxTokens,
                      const ::std::string &            delimiterSet = " ",
                      bool                             skipNull = true );

    static ::std::vector< ::std::string >
    tokenizeN( const ::std::string & str,
               const size_t          maxTokens,
               const ::std::string & delimiterSet = " ",
               bool                  skipNull = true );

    static bool miniGlob(const char *pattern, const char *checkString);

    static int stringToInt(const ::std::string& str);

    static ::std::string  hms(double angle, int precision=2);
    static ::std::string  dms(double angle, int precision=3);
    static ::std::string shms(double angle, int precision=2);
    static ::std::string sdms(double angle, int precision=3);
    static ::std::string sexa(double angle, bool sign, bool hms, int precision);

    static ::std::string
    computeMessageDigest( const ::std::string & str,
                          DigestType            digestType );



    static bool equalsIgnoreCase(const std::string & aString,
                                 const std::string & anotherString);

    static bool containsOnly( const ::std::string & str,
                              const ::std::string & allowedChars );
    static ::std::string sort( const ::std::string & str,
                               const sortType direction = ASCENDING_SORT);

    static ::std::string uniq( const ::std::string & str);

    static ::std::string reallyUniq( const ::std::string & str);

    static bool isEmptyOrContainsWhiteSpace( const ::std::string & s);
};



}}
#endif  // CARMA_UTIL_STRINGUTILS_H