Enumerations | |
enum | Trim { NO_TRIM = 0x00, L_TRIM = 0x01, R_TRIM = 0x02, TRIM = (L_TRIM|R_TRIM) } |
Functions | |
std::string | form (const char *format,...) __attribute__((format(printf |
std::string | numstring (char n, int w=0) |
std::string | numstring (unsigned char n, int w=0) |
std::string | numstring (short n, int w=0) |
std::string | numstring (unsigned short n, int w=0) |
std::string | numstring (int n, int w=0) |
std::string | numstring (unsigned n, int w=0) |
std::string | numstring (long n, int w=0) |
std::string | numstring (unsigned long n, int w=0) |
std::string | numstring (long long n, int w=0) |
std::string | numstring (unsigned long long n, int w=0) |
std::string | hexstring (char n, int w=4) |
std::string | hexstring (unsigned char n, int w=4) |
std::string | hexstring (short n, int w=10) |
std::string | hexstring (unsigned short n, int w=10) |
std::string | hexstring (int n, int w=10) |
std::string | hexstring (unsigned n, int w=10) |
std::string | hexstring (long n, int w=10) |
std::string | hexstring (unsigned long n, int w=10) |
std::string | hexstring (long long n, int w=0) |
std::string | hexstring (unsigned long long n, int w=0) |
std::string | octstring (char n, int w=4) |
std::string | octstring (unsigned char n, int w=4) |
std::string | octstring (short n, int w=5) |
std::string | octstring (unsigned short n, int w=5) |
std::string | octstring (int n, int w=5) |
std::string | octstring (unsigned n, int w=5) |
std::string | octstring (long n, int w=5) |
std::string | octstring (unsigned long n, int w=5) |
std::string | octstring (long long n, int w=0) |
std::string | octstring (unsigned long long n, int w=0) |
template<typename _It> | |
_It | strtonum (const std::string &str) |
template<typename _It> | |
_It | strtonum (const std::string &str, _It &i) |
std::string | getline (std::istream &str, bool trim=false) |
read one line from a stream Return one line read from istream. Afterwards the streampos is behind the delimiting ' ' (or at EOF). The delimiting ' ' is not returned. | |
std::string | getline (std::istream &str, const Trim trim_r) |
read one line from a stream | |
unsigned | split (const std::string line_r, std::vector< std::string > &words_r, const std::string &sep_t=" \t", const bool singlesep_r=false) |
std::string | join (const std::vector< std::string > &words_r, const std::string &sep_r=" ") |
std::list< std::string > | splitToLines (const std::string text_r, const std::string &sep_r="\n") |
std::string | stripFirstWord (std::string &value, const bool ltrim_first=false) |
std::string | ltrim (const std::string &s) |
std::string | rtrim (const std::string &s) |
std::string | trim (const std::string &s, const Trim trim_r=TRIM) |
std::string | toLower (const std::string &s) |
std::string | toUpper (const std::string &s) |
std::ostream & | dumpOn (std::ostream &str, const std::list< std::string > &l, const bool numbered=false) |
std::ostream & | dumpOn (std::ostream &str, const std::vector< std::string > &l, const bool numbered=false) |
|
|
|
|
|
Helper for stream output |
|
Printf style building of strings via format string. std::string ex( stringutil::form( "Example number %d", 1 ) ); std::cout << ex << stringutil::form( " and number %d.", 2 ) << endl;
Will print: Example number 1 and number 2. |
|
read one line from a stream like above but with allows to specify trimming direction |
|
read one line from a stream Return one line read from istream. Afterwards the streampos is behind the delimiting ' If trim is true, the string returned is trimmed (surrounding whitespaces removed). ifstream s( "somefile" );
while ( s ) { string l = getline( s ); if ( !(s.fail() || s.bad()) ) {
// l contains valid data to be consumed. // In case it makes any difference to you: if ( s.good() ) { // A delimiting ' |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Print number as hex value with leading '0x'. Optional second argument sets the minimal string width (0 padded). Negative values will cause the number to be left adjusted within the string. Default width is 10 (4 for char). hexstring(42) -> "0x0000002a" hexstring(42, 4) -> "0x2a" hexstring(42,-4) -> "0x2a" |
|
Join strinngs in words_r using separator sep_r |
|
Return string with leading/trailing/surrounding whitespace removed |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Print number. Optional second argument sets the minimal string width (' ' padded). Negative values will cause the number to be left adjusted within the string. Default width is 0. numstring(42) -> "42" numstring(42, 4) -> " 42" numstring(42,-4) -> "42 " |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Print number as octal value with leading '0'. Optional second argument sets the minimal string width (0 padded). Negative values will cause the number to be left adjusted within the string. Default width is 5 (4 for char). octstring(42) -> "00052" octstring(42, 4) -> "0052" octstring(42,-4) -> "052 " |
|
|
|
Split line into words singlesep_r = false: Separator is any nonenmpty sequence of characters listed in sep_t. Leading trailing separators are ignored. Example: singlesep_r = false, sep_t = ":" "" -> words 0 ":" -> words 0 "a" -> words 1 |a| "::a" -> words 1 |a| "::a::" -> words 1 |a| ":a::b:c:"-> words 3 |a|b|c| singlesep_r = true: Separator is any single character occuring in sep_t. Leading trailing separators are not ignored (i.e will cause an empty word). Example: singlesep_r = true, sep_t = ":" "" -> words 0 ":" -> words 2 ||| "a" -> words 1 |a| ":a" -> words 2 ||a| "a:" -> words 2 |a|| ":a:" -> words 3 ||a|| |
|
Split string into a list of lines using any< char in sep_r as line delimiter. The delimiter is stripped from the line.
|
|
Strip the first word (delimited by blank or tab) from value, and return it. Adjust value to start with the second word afterwards. If value starts with blank or tab, the first word is empty and value will be ltrimmed afterwards. If ltrim_first is true, value will be ltrimmed before stripping the first word. Thus first word is empty, iff value is empty or contains whitespace only.
stripFirstWord( "1st" ) == "1st" and value truncated to "" stripFirstWord( "1st word" ) == "1st" and value truncated to "word" stripFirstWord( " 1st word" ) == "" and value truncated to "1st word" stripFirstWord( " 1st word", true ) == "1st" and value truncated to "word" |
|
String to integer type detemined function arg: time_t t; strtonum( "42", t ); |
|
String to integer type determined by template arg: time_t t = strtonum<time_t>( "42" ); |
|
Return string converted to lower/upper case |
|
|
|
|