-// String utilities.
-//
-// Written by Bernie Bright, 1998
+/**
+ * \file strutils.hxx
+ * String utilities.
+ */
+
+// Written by Bernie Bright, started 1998
//
-// Copyright (C) 1998 Bernie Bright - bbright@c031.aone.net.au
+// Copyright (C) 1998 Bernie Bright - bbright@bigpond.net.au
//
-// This program is free software; you can redistribute it and/or
-// modify it under the terms of the GNU General Public License as
-// published by the Free Software Foundation; either version 2 of the
-// License, or (at your option) any later version.
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Library General Public
+// License as published by the Free Software Foundation; either
+// version 2 of the License, or (at your option) any later version.
//
-// This program is distributed in the hope that it will be useful, but
-// WITHOUT ANY WARRANTY; without even the implied warranty of
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// General Public License for more details.
+// Library General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
-// Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
//
// $Id$
+
#ifndef STRUTILS_H
#define STRUTILS_H
#include <simgear/compiler.h>
-#include STL_STRING
+#include <string>
+#include <vector>
+#include <cstdlib>
+
+typedef std::vector < std::string > string_list;
+
+namespace simgear {
+ namespace strutils {
+
+// /**
+// * atof() wrapper for "string" type
+// */
+// inline double
+// atof( const string& str )
+// {
+// return ::atof( str.c_str() );
+// }
+
+// /**
+// * atoi() wrapper for "string" type
+// */
+// inline int
+// atoi( const string& str )
+// {
+// return ::atoi( str.c_str() );
+// }
+
+ /**
+ * Strip leading and/or trailing whitespace from s.
+ * @param s String to strip.
+ * @return The stripped string.
+ */
+ 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.
+ * Produces a result similar to the perl and python functions of the
+ * same name.
+ *
+ * @param s The string to split into words,
+ * @param sep Word delimiters. If not specified then any whitespace is a separator,
+ * @param maxsplit If given, splits at no more than maxsplit places,
+ * resulting in at most maxsplit+1 words.
+ * @return Array of words.
+ */
+ string_list
+ split( const std::string& s,
+ const char* sep = 0,
+ int maxsplit = 0 );
-#ifdef FG_HAVE_STD_INCLUDES
-# include <cstdlib>
-#else
-# include <stdlib.h>
-#endif
+ /**
+ * 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 = "");
-FG_USING_STD(string);
+ /**
+ * 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 );
-// Default characters to remove.
-extern const string whitespace;
+ /**
+ * 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);
-// Returns a string with trailing characters removed.
-string trimleft( const string& s, const string& trimmings = whitespace );
+ /**
+ * Convert a string to upper case.
+ * @return upper case string
+ */
+ std::string uppercase(const std::string &s);
-// Returns a string with leading characters removed.
-string trimright( const string& s, const string& trimmings = whitespace );
+ /**
+ * 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);
-// Returns a string with leading and trailing characters removed.
-string trim( const string& s, const string& trimmings = whitespace );
+ /**
+ * 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 double
-atof( const string& str )
-{
- return ::atof( str.c_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);
-inline int
-atoi( const string& str )
-{
- return ::atoi( str.c_str() );
-}
+ } // end namespace strutils
+} // end namespace simgear
#endif // STRUTILS_H