]> git.mxchange.org Git - simgear.git/blobdiff - simgear/misc/strutils.hxx
Fixed mingw build.
[simgear.git] / simgear / misc / strutils.hxx
index 05c559980357145d1a14d9d3bc84f7595b77b228..9bd1dbe1851fc20637cb8a5829cb32de05691e26 100644 (file)
 
 #include <simgear/compiler.h>
 
-#include STL_STRING
-
+#include <string>
 #include <vector>
-SG_USING_STD(vector);
-
-#ifdef SG_HAVE_STD_INCLUDES
-#  include <cstdlib>
-#else
-#  include <stdlib.h>
-#endif
+#include <cstdlib>
 
-SG_USING_STD(string);
+typedef std::vector < std::string > string_list;
 
 namespace simgear {
-    namespace strutils {
+  namespace strutils {
 
 //     /** 
 //      * atof() wrapper for "string" type
@@ -68,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.
@@ -83,12 +94,55 @@ namespace simgear {
         * resulting in at most maxsplit+1 words.
         * @return Array of words.
         */
-       vector<string>
-       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