X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=simgear%2Fmisc%2Fstrutils.hxx;h=9bd1dbe1851fc20637cb8a5829cb32de05691e26;hb=619163d40e6beeaf08759944d80256692395ec9e;hp=aa395a250a29e26bf44a9cd861b6c686dcf7a018;hpb=d4c7e950927b1e19a7a7622a7919f32233a6b7a8;p=simgear.git diff --git a/simgear/misc/strutils.hxx b/simgear/misc/strutils.hxx index aa395a25..9bd1dbe1 100644 --- a/simgear/misc/strutils.hxx +++ b/simgear/misc/strutils.hxx @@ -30,16 +30,13 @@ #include #include - #include -using std::vector; - #include -using std::string; +typedef std::vector < std::string > string_list; namespace simgear { - namespace strutils { + namespace strutils { // /** // * atof() wrapper for "string" type @@ -64,9 +61,27 @@ namespace simgear { * @param s String to strip. * @return The stripped string. */ - string lstrip( const string& s ); - string rstrip( const string& s ); - string strip( const string& s ); + std::string lstrip( const std::string& s ); + std::string rstrip( const std::string& s ); + std::string strip( const std::string& s ); + + /** + * Right-padding of a string to a given length + * @param s String to pad + * @param length The total length of the resulting string + * @param c The character to pad with + * @return The padded string + */ + std::string rpad( const std::string & s, size_t length, char c ); + + /** + * Left-padding of a string to a given length + * @param s String to pad + * @param length The total length of the resulting string + * @param c The character to pad with + * @return The padded string + */ + std::string lpad( const std::string & s, size_t length, char c ); /** * Split a string into a words using 'sep' as the delimiter string. @@ -79,12 +94,55 @@ namespace simgear { * resulting in at most maxsplit+1 words. * @return Array of words. */ - vector - split( const string& s, + string_list + split( const std::string& s, const char* sep = 0, int maxsplit = 0 ); - } // end namespace strutils + /** + * create a single string by joining the elements of a list with + * another string. + */ + std::string join(const string_list& l, const std::string& joinWith = ""); + + /** + * Test if a string starts with a string + * + * @param s The string to be tested + * @param substr The string to test + * @return True, if s starts with substr, False otherwise + */ + bool starts_with( const std::string & s, const std::string & substr ); + + /** + * Test if a string ends with a string + * + * @param s The string to be tested + * @param substr The string to test + * @return True, if s ends with substr, False otherwise + */ + bool ends_with( const std::string & s, const std::string & substr ); + + /** + * Strip all leading/trailing whitespace, and transform all interal + * whitespace into a single ' ' character - i.e newlines/carriage returns/ + * tabs/multiple spaces will be condensed. + */ + std::string simplify(const std::string& s); + + /** + * convert a string representing a decimal number, to an int + */ + int to_int(const std::string& s, int base = 10); + + /** + * Like strcmp(), but for dotted versions strings NN.NN.NN + * any number of terms are support. + * @return 0 if versions match, -ve number if v1 is lower, +ve if v1 + * is greater + */ + int compare_versions(const std::string& v1, const std::string& v2); + } // end namespace strutils } // end namespace simgear #endif // STRUTILS_H