string_utilities.h

Go to the documentation of this file.

 
#ifndef STRING_UTILITIES_H
#define STRING_UTILITIES_H
 
#include <argos3/core/utility/configuration/argos_exception.h>
#include <argos3/core/utility/datatypes/datatypes.h>
#include <string>
#include <vector>
#include <sstream>
 
namespace argos {
 
   /****************************************/
   /****************************************/
 
   template<typename T> std::string ToString(const T& t_value) {
      std::ostringstream ss;
      ss.setf(std::ios::boolalpha);
      ss << t_value;
      return ss.str();
   }
 
   /****************************************/
   /****************************************/
 
   template<typename T> T FromString(const std::string& str_value) {
      T tReturnValue;
      std::istringstream ss(str_value);
      ss.setf(std::ios::boolalpha);
      ss >> tReturnValue;
      return tReturnValue;
   }
 
   /****************************************/
   /****************************************/
 
   template<typename T> void ParseValues(std::istream& str_input,
                                         UInt32 un_num_fields,
                                         T* pt_field_buffer,
                                         const char ch_delimiter = '\n') {
      std::vector<std::string> s(un_num_fields);
      UInt32 i = 0;
      while(i < un_num_fields && std::getline(str_input, s[i], ch_delimiter)) {
         i++;
      }
      if (i == un_num_fields) {
         str_input.clear(); // the istream was read completely and this is fine, so set the flag to 'good'
         for(i = 0; i < un_num_fields; i++) {
            std::istringstream iss(s[i]);
            iss >> pt_field_buffer[i];
         }
      }
      else {
         THROW_ARGOSEXCEPTION("Parse error: expected " << un_num_fields
                              << " values, but " << i << " have been found in \""
                              << str_input.rdbuf() << "\"");
      }
   }
 
   /****************************************/
   /****************************************/
 
   template<typename T> void ParseValues(const std::string& str_input,
                                         const UInt32 un_num_fields,
                                         T* pt_field_buffer,
                                         const char ch_delimiter = '\n') {
      std::istringstream issInput(str_input);
      ParseValues(issInput, un_num_fields, pt_field_buffer, ch_delimiter);
   }
 
   /****************************************/
   /****************************************/
 
      void Tokenize(const std::string& str_string,
                    std::vector<std::string>& vec_tokens,
                    const std::string& str_delimiters = " ");
 
      std::string StringToUpperCase(const std::string& str_string);
 
      std::string StringToLowerCase(const std::string& str_string);
 
      /****************************************/
      /****************************************/
 
      void Replace(std::string& str_buffer,
                   const std::string& str_original,
                   const std::string& str_new);
 
      /****************************************/
      /****************************************/
 
      bool MatchPattern(const std::string& str_input,
                        const std::string& str_pattern);
 
      /****************************************/
      /****************************************/
 
      std::string& ExpandEnvVariables(std::string& str_buffer);
 
      /****************************************/
      /****************************************/
 
}
 
#endif