#include <vector>
#include <cstdlib>
+typedef std::vector < std::string > string_list;
namespace simgear {
namespace strutils {
+ /**
+ * utf8ToLatin1() convert utf8 to latin, useful for accent character (i.e éâàîè...)
+ */
+ std::string utf8ToLatin1( std::string & s_utf8 );
+
// /**
// * atof() wrapper for "string" type
// */
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.
* Produces a result similar to the perl and python functions of the
* resulting in at most maxsplit+1 words.
* @return Array of words.
*/
- std::vector<std::string>
+ string_list
split( const std::string& s,
const char* sep = 0,
int maxsplit = 0 );
+ /**
+ * 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 = "");
- std::string convertToLowerCase(const std::string& str);
+ /**
+ * 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 supported.
+ * @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);
+
+ /**
+ * Convert a string to upper case.
+ * @return upper case string
+ */
+ std::string uppercase(const std::string &s);
+
+ /**
+ * Convert a string to lower case.
+ * @return lower case string
+ */
+ std::string lowercase(const std::string &s);
+
+ /**
+ * Convert a string to lower case in place
+ */
+ void lowercase(std::string &s);
+
+ /**
+ * convert a string in the local Windows 8-bit encoding to UTF-8
+ * (no-op on other platforms)
+ */
+ std::string convertWindowsLocal8BitToUtf8(const std::string& a);
+
+#if defined(SG_WINDOWS)
+ typedef std::vector<wchar_t> WCharVec;
+ WCharVec convertUtf8ToWString(const std::string& a);
+#endif
+
+ /**
+ * convert base-64 encoded data to raw bytes (possibly with embedded
+ * NULs). Throws an exception if input data is not base64, or is
+ * malformed
+ */
+ void decodeBase64(const std::string& a, std::vector<unsigned char>& output);
+
+ /**
+ * convert bytes to hexadecimal equivalent
+ */
+ std::string encodeHex(const std::string& bytes);
+
+ std::string encodeHex(const unsigned char* rawBytes, unsigned int length);
+
+ /**
+ * Unescape string.
+ *
+ * @param str String possibly containing escaped characters.
+ * @return string with escaped characters replaced by single character
+ * values.
+ */
+ std::string unescape(const char* str);
+
+ inline std::string unescape(const std::string& str)
+ { return unescape(str.c_str()); }
+
+ /**
+ * Check a printf-style format string for dangerous (buffer-overflowing,
+ * memory re-writing) format tokens. If a problematic token is
+ * found, logs an error (SG_WARN) and returns an empty format string.
+ */
+ std::string sanitizePrintfFormat(const std::string& input);
+
} // end namespace strutils
} // end namespace simgear