String.h revision 10447
110447Snilay@cs.wisc.edu#ifndef __STRING_H__ 210447Snilay@cs.wisc.edu#define __STRING_H__ 310447Snilay@cs.wisc.edu 410447Snilay@cs.wisc.edu#include <string> 510447Snilay@cs.wisc.edu#include <cstdarg> 610447Snilay@cs.wisc.edu#include <vector> 710447Snilay@cs.wisc.edu#include <sstream> 810447Snilay@cs.wisc.edu#include <bitset> 910447Snilay@cs.wisc.edu 1010447Snilay@cs.wisc.edunamespace LibUtil 1110447Snilay@cs.wisc.edu{ 1210447Snilay@cs.wisc.edu using std::string; 1310447Snilay@cs.wisc.edu using std::vector; 1410447Snilay@cs.wisc.edu 1510447Snilay@cs.wisc.edu class String : public string 1610447Snilay@cs.wisc.edu { 1710447Snilay@cs.wisc.edu public: 1810447Snilay@cs.wisc.edu static String format(const String& format_, ...); 1910447Snilay@cs.wisc.edu static String format(const String& format_, va_list args_); 2010447Snilay@cs.wisc.edu template<class T> static String toString(const T& value_); 2110447Snilay@cs.wisc.edu static String toBitString(unsigned int value_, unsigned int num_bits_); 2210447Snilay@cs.wisc.edu template<class T> static T fromString(const String& str_); 2310447Snilay@cs.wisc.edu 2410447Snilay@cs.wisc.edu private: 2510447Snilay@cs.wisc.edu static const unsigned int msBufferSize; 2610447Snilay@cs.wisc.edu 2710447Snilay@cs.wisc.edu public: 2810447Snilay@cs.wisc.edu String(); 2910447Snilay@cs.wisc.edu String(const string& str_); 3010447Snilay@cs.wisc.edu String(const char* str_, size_t n); 3110447Snilay@cs.wisc.edu String(const char* str_); 3210447Snilay@cs.wisc.edu String(size_t n, char c); 3310447Snilay@cs.wisc.edu String(int value_); 3410447Snilay@cs.wisc.edu String(unsigned int value_); 3510447Snilay@cs.wisc.edu String(long value_); 3610447Snilay@cs.wisc.edu String(unsigned long value_); 3710447Snilay@cs.wisc.edu String(float value_); 3810447Snilay@cs.wisc.edu String(double value_); 3910447Snilay@cs.wisc.edu String(bool value_); 4010447Snilay@cs.wisc.edu ~String(); 4110447Snilay@cs.wisc.edu 4210447Snilay@cs.wisc.edu public: 4310447Snilay@cs.wisc.edu // Remove leading and trailing whitespace 4410447Snilay@cs.wisc.edu String& trim(); 4510447Snilay@cs.wisc.edu // Substitute str1 with str2 4610447Snilay@cs.wisc.edu String& substitute(const String& str1_, const String& str2_); 4710447Snilay@cs.wisc.edu // Split the String into vector of Strings separated by delimiters_ 4810447Snilay@cs.wisc.edu vector<String> split(const char* delimiters_) const; 4910447Snilay@cs.wisc.edu vector<String> split(const String* delimiters_, unsigned int num_delimiters_ = 1) const; 5010447Snilay@cs.wisc.edu vector<String> splitByString(const String& delimiters_) const; 5110447Snilay@cs.wisc.edu 5210447Snilay@cs.wisc.edu // Check if contains str 5310447Snilay@cs.wisc.edu bool contain(const String& str_) const; 5410447Snilay@cs.wisc.edu 5510447Snilay@cs.wisc.edu public: 5610447Snilay@cs.wisc.edu // Convertions 5710447Snilay@cs.wisc.edu const char* toCString() const; 5810447Snilay@cs.wisc.edu int toInt() const; 5910447Snilay@cs.wisc.edu unsigned int toUInt() const; 6010447Snilay@cs.wisc.edu long toLong() const; 6110447Snilay@cs.wisc.edu unsigned long toULong() const; 6210447Snilay@cs.wisc.edu float toFloat() const; 6310447Snilay@cs.wisc.edu double toDouble() const; 6410447Snilay@cs.wisc.edu bool toBool() const; 6510447Snilay@cs.wisc.edu operator const char*() const; 6610447Snilay@cs.wisc.edu operator int() const; 6710447Snilay@cs.wisc.edu operator unsigned int() const; 6810447Snilay@cs.wisc.edu operator long() const; 6910447Snilay@cs.wisc.edu operator unsigned long() const; 7010447Snilay@cs.wisc.edu operator float() const; 7110447Snilay@cs.wisc.edu operator double() const; 7210447Snilay@cs.wisc.edu operator bool() const; 7310447Snilay@cs.wisc.edu String& operator=(char c_); 7410447Snilay@cs.wisc.edu }; 7510447Snilay@cs.wisc.edu 7610447Snilay@cs.wisc.edu template<class T> String String::toString(const T& value_) 7710447Snilay@cs.wisc.edu { 7810447Snilay@cs.wisc.edu std::ostringstream ost; 7910447Snilay@cs.wisc.edu ost << value_; 8010447Snilay@cs.wisc.edu return ost.str(); 8110447Snilay@cs.wisc.edu } 8210447Snilay@cs.wisc.edu 8310447Snilay@cs.wisc.edu template<> inline String String::toString<bool>(const bool& value_) 8410447Snilay@cs.wisc.edu { 8510447Snilay@cs.wisc.edu if(value_ == true) 8610447Snilay@cs.wisc.edu { 8710447Snilay@cs.wisc.edu return "TRUE"; 8810447Snilay@cs.wisc.edu } 8910447Snilay@cs.wisc.edu else 9010447Snilay@cs.wisc.edu { 9110447Snilay@cs.wisc.edu return "FALSE"; 9210447Snilay@cs.wisc.edu } 9310447Snilay@cs.wisc.edu } 9410447Snilay@cs.wisc.edu 9510447Snilay@cs.wisc.edu inline String String::toBitString(unsigned int value_, unsigned int num_bits_) 9610447Snilay@cs.wisc.edu { 9710447Snilay@cs.wisc.edu std::bitset<sizeof(unsigned int)*8> bitSet(value_); 9810447Snilay@cs.wisc.edu String ret = String(bitSet.to_string()); 9910447Snilay@cs.wisc.edu ret = ret.substr(ret.length()-num_bits_); 10010447Snilay@cs.wisc.edu return ret; 10110447Snilay@cs.wisc.edu } 10210447Snilay@cs.wisc.edu 10310447Snilay@cs.wisc.edu template<class T> T String::fromString(const String& str_) 10410447Snilay@cs.wisc.edu { 10510447Snilay@cs.wisc.edu T ret; 10610447Snilay@cs.wisc.edu std::istringstream ist(str_); 10710447Snilay@cs.wisc.edu ist >> ret; 10810447Snilay@cs.wisc.edu return ret; 10910447Snilay@cs.wisc.edu } 11010447Snilay@cs.wisc.edu 11110447Snilay@cs.wisc.edu template<> inline String String::fromString<String>(const String& str_) 11210447Snilay@cs.wisc.edu { 11310447Snilay@cs.wisc.edu return str_; 11410447Snilay@cs.wisc.edu } 11510447Snilay@cs.wisc.edu 11610447Snilay@cs.wisc.edu template<> inline bool String::fromString<bool>(const String& str_) 11710447Snilay@cs.wisc.edu { 11810447Snilay@cs.wisc.edu bool ret; 11910447Snilay@cs.wisc.edu if((str_ == String("TRUE")) || (str_ == String("true"))) 12010447Snilay@cs.wisc.edu { 12110447Snilay@cs.wisc.edu ret = true; 12210447Snilay@cs.wisc.edu } 12310447Snilay@cs.wisc.edu else if((str_ == string("FALSE")) || (str_ == String("false"))) 12410447Snilay@cs.wisc.edu { 12510447Snilay@cs.wisc.edu ret = false; 12610447Snilay@cs.wisc.edu } 12710447Snilay@cs.wisc.edu else 12810447Snilay@cs.wisc.edu { 12910447Snilay@cs.wisc.edu //std::cerr << "Invalid bool value: " << str_ << std::endl; 13010447Snilay@cs.wisc.edu throw ("Invalid bool value: " + str_); 13110447Snilay@cs.wisc.edu } 13210447Snilay@cs.wisc.edu return ret; 13310447Snilay@cs.wisc.edu } 13410447Snilay@cs.wisc.edu 13510447Snilay@cs.wisc.edu template<class T> String arrayToString( 13610447Snilay@cs.wisc.edu const T* array_, unsigned int start_index_, unsigned int end_index_, 13710447Snilay@cs.wisc.edu const String& delimiters_ 13810447Snilay@cs.wisc.edu ) 13910447Snilay@cs.wisc.edu { 14010447Snilay@cs.wisc.edu // Ensure end_index_ >= start_index_ + 1 14110447Snilay@cs.wisc.edu if(end_index_ <= start_index_) 14210447Snilay@cs.wisc.edu { 14310447Snilay@cs.wisc.edu throw("Invalid index range: start_index = " + (String)start_index_ + ", end_index = " + (String)end_index_); 14410447Snilay@cs.wisc.edu } 14510447Snilay@cs.wisc.edu 14610447Snilay@cs.wisc.edu String ret = "["; 14710447Snilay@cs.wisc.edu for(unsigned int i = start_index_; i < (end_index_-1); ++i) 14810447Snilay@cs.wisc.edu { 14910447Snilay@cs.wisc.edu ret += (String)array_[i] + delimiters_; 15010447Snilay@cs.wisc.edu } 15110447Snilay@cs.wisc.edu ret += (String)array_[end_index_-1] + "]"; 15210447Snilay@cs.wisc.edu return ret; 15310447Snilay@cs.wisc.edu } 15410447Snilay@cs.wisc.edu 15510447Snilay@cs.wisc.edu template<class T> String arrayToString(const T* array_, unsigned int num_elements_) 15610447Snilay@cs.wisc.edu { 15710447Snilay@cs.wisc.edu return arrayToString(array_, 0, num_elements_, ", "); 15810447Snilay@cs.wisc.edu } 15910447Snilay@cs.wisc.edu 16010447Snilay@cs.wisc.edu template<class T> String arrayToString(const T* array_, unsigned int start_index_, unsigned int end_index_) 16110447Snilay@cs.wisc.edu { 16210447Snilay@cs.wisc.edu return arrayToString(array_, start_index_, end_index_); 16310447Snilay@cs.wisc.edu } 16410447Snilay@cs.wisc.edu 16510447Snilay@cs.wisc.edu template<class T> String vectorToString( 16610447Snilay@cs.wisc.edu const vector<T>& vector_, unsigned int start_index_, unsigned int end_index_, 16710447Snilay@cs.wisc.edu const String& delimiters_ 16810447Snilay@cs.wisc.edu ) 16910447Snilay@cs.wisc.edu { 17010447Snilay@cs.wisc.edu // Ensure end_index_ >= start_index_ + 1, or if the vector is empty 17110447Snilay@cs.wisc.edu if((end_index_ <= start_index_) || (end_index_ > vector_.size())) 17210447Snilay@cs.wisc.edu { 17310447Snilay@cs.wisc.edu // If the vector is empty, return empty array 17410447Snilay@cs.wisc.edu if (vector_.size() == 0) 17510447Snilay@cs.wisc.edu return "[]"; 17610447Snilay@cs.wisc.edu 17710447Snilay@cs.wisc.edu throw("Invalid index range: start_index = " + (String)start_index_ + ", end_index = " + (String)end_index_); 17810447Snilay@cs.wisc.edu } 17910447Snilay@cs.wisc.edu 18010447Snilay@cs.wisc.edu String ret = "["; 18110447Snilay@cs.wisc.edu for(unsigned int i = start_index_; i < (end_index_-1); ++i) 18210447Snilay@cs.wisc.edu { 18310447Snilay@cs.wisc.edu ret += (String)vector_[i] + delimiters_; 18410447Snilay@cs.wisc.edu } 18510447Snilay@cs.wisc.edu ret += (String)vector_[end_index_-1] + "]"; 18610447Snilay@cs.wisc.edu return ret; 18710447Snilay@cs.wisc.edu } 18810447Snilay@cs.wisc.edu 18910447Snilay@cs.wisc.edu template<class T> String vectorToString(const vector<T>& vector_) 19010447Snilay@cs.wisc.edu { 19110447Snilay@cs.wisc.edu return vectorToString(vector_, 0, vector_.size(), ", "); 19210447Snilay@cs.wisc.edu } 19310447Snilay@cs.wisc.edu 19410447Snilay@cs.wisc.edu template<class T> String vectorToString(const vector<T>& vector_, unsigned int num_elements_) 19510447Snilay@cs.wisc.edu { 19610447Snilay@cs.wisc.edu return vectorToString(vector_, 0, num_elements_, ", "); 19710447Snilay@cs.wisc.edu } 19810447Snilay@cs.wisc.edu 19910447Snilay@cs.wisc.edu template<class T> String vectorToString(const vector<T>& vector_, unsigned int start_index_, unsigned int end_index_) 20010447Snilay@cs.wisc.edu { 20110447Snilay@cs.wisc.edu return vectorToString(vector_, start_index_, end_index_); 20210447Snilay@cs.wisc.edu } 20310447Snilay@cs.wisc.edu 20410447Snilay@cs.wisc.edu template<class T> vector<T> castStringVector(const vector<String>& vector_) 20510447Snilay@cs.wisc.edu { 20610447Snilay@cs.wisc.edu vector<T> ret_vector; 20710447Snilay@cs.wisc.edu for(unsigned int i = 0; i < vector_.size(); ++i) 20810447Snilay@cs.wisc.edu { 20910447Snilay@cs.wisc.edu ret_vector.push_back((T)vector_[i]); 21010447Snilay@cs.wisc.edu } 21110447Snilay@cs.wisc.edu return ret_vector; 21210447Snilay@cs.wisc.edu } 21310447Snilay@cs.wisc.edu 21410447Snilay@cs.wisc.edu std::istream& safeGetline(std::istream& is_, String& str_); 21510447Snilay@cs.wisc.edu} // namespace LibUtil 21610447Snilay@cs.wisc.edu 21710447Snilay@cs.wisc.edu#endif // __STRING_H__ 21810447Snilay@cs.wisc.edu 219