* String utilities.
*/
-// Written by Bernie Bright, 1998
+// 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 library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Library General Public
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
// Library General Public License for more details.
//
-// You should have received a copy of the GNU Library General Public
-// License along with this library; if not, write to the
-// Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-// Boston, MA 02111-1307, USA.
+// 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
//
// $Id$
#include <simgear/compiler.h>
-#include STL_STRING
-
-#ifdef SG_HAVE_STD_INCLUDES
-# include <cstdlib>
-#else
-# include <stdlib.h>
-#endif
-
-SG_USING_STD(string);
-
-
-/** Default characters to remove. */
-extern const string whitespace;
-
-/** Returns a string with trailing characters removed. */
-string trimleft( const string& s, const string& trimmings = whitespace );
-
-/** Returns a string with leading characters removed. */
-string trimright( const string& s, const string& trimmings = whitespace );
-
-/** Returns a string with leading and trailing characters removed. */
-string trim( const string& s, const string& trimmings = whitespace );
-
-/** 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() );
-}
+#include <string>
+#include <vector>
+#include <cstdlib>
+
+
+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.
+ */
+ std::vector<std::string>
+ split( const std::string& s,
+ const char* sep = 0,
+ int maxsplit = 0 );
+
+ } // end namespace strutils
+} // end namespace simgear
#endif // STRUTILS_H