stringManipulation.h

Go to the documentation of this file.

#ifndef _DLR_STRINGMANIPULATION_H_
#define _DLR_STRINGMANIPULATION_H_

#include <iostream>
#include <sstream>
#include <string>
#include <vector>
#include <dlrCommon/exception.h>
#include <dlrCommon/tags.h>
#include <dlrUtilities/exception.h>

namespace dlr {

  namespace utilities {
    
    std::string
    cleanString(const std::string& inputString,
                const std::string& 
                specialCharacters="\"~#$&*()\\|[]{};'`<>/?",
                char quoteCharacter='\\',
                bool alreadyQuoted=false);
  

    template <class Type>
    Type
    convertString(const std::string& inputString);

  
    template <class Type>
    inline Type
    convertString(const std::string& inputString, type_tag<Type>);

  
    std::string
    joinString(const std::vector<std::string>& inputStringVector,
               const std::string& separator="");
  

    std::string
    lowerCaseString(const std::string& inputString);
  

    std::string
    replaceString(const std::string& inputString,
                  const std::string& target,
                  const std::string& replacement);


    std::vector<std::string>
    splitString(const std::string& inputString,
                const std::string& delimiter,
                bool includeNullStrings=false,
                size_t maxSplit=0);

  
    std::string
    stripString(const std::string& inputString,
                const std::string& whiteSpace=" \t\n");


    std::string
    upperCaseString(const std::string& inputString);


    std::string
    wrapString(const std::string& inputString,
               const std::string& fillPrefix="",
               size_t width=78,
               const std::string& whitespace=" \t\n",
               const std::string& eolString="\n");


    inline std::string
    wrapString(const std::string& inputString,
               size_t width,
               const std::string& whitespace=" \t\n",
               const std::string& eolString="\n") {
      return wrapString(inputString, "", width, whitespace, eolString);
    }

  } // namespace utilities
  
} // namespace dlr


/* ******************************************************************
 * Declarations to maintain compatibility with legacy code.
 * ***************************************************************** */

namespace dlr {

  using utilities::cleanString;
  using utilities::convertString;
  using utilities::joinString;
  using utilities::lowerCaseString;
  using utilities::replaceString;
  using utilities::splitString;
  using utilities::stripString;
  using utilities::upperCaseString;
  using utilities::wrapString;

} // namespace dlr


/* ******************************************************************
 * Definitions of inline and template functions.
 * ***************************************************************** */

namespace dlr {

  namespace utilities {
    
    // Converts the string inputString to Type.
    template <class Type>
    Type
    convertString(const std::string& inputString)
    {
      Type returnValue;
      std::istringstream inputStream(inputString);
      inputStream >> returnValue;
      if(!inputStream) {
        std::ostringstream message;
        message << "Can't convert malformed input string: " << inputString
                << std::endl;
        DLR_THROW(ConversionException, "convertString()", message.str().c_str());
      }
      return returnValue;
    }

  
    // Converts the string inputString to Type.
    template <class Type>
    inline Type
    convertString(const std::string& inputString, type_tag<Type>)
    {
      return convertString<Type>(inputString);
    }

  } // namespace utilities
  
} // namespace dlr

#endif // #ifndef _DLR_STRINGMANIPULATION_H_

---