// -*- C++ -*-
-
-/** String helper functions.
- \file lstrings.h
- This is a collection of string helper functions that works
- together with string (and later also with STL String. Some of these
- would certainly benefit from a rewrite/optimization.
- \author Lars Gullik Bjønnes
- \author Jean-Marc Lasgouttes
-*/
+/**
+ * \file lstrings.h
+ * This file is part of LyX, the document processor.
+ * Licence details can be found in the file COPYING.
+ *
+ * \author Lars Gullik Bjønnes
+ * \author Jean-Marc Lasgouttes
+ *
+ * Full author contact details are available in file CREDITS.
+ *
+ * A collection of string helper functions that works with string.
+ * Some of these would certainly benefit from a rewrite/optimization.
+ */
#ifndef LSTRINGS_H
#define LSTRINGS_H
-#ifdef __GNUG__
-#pragma interface
-#endif
-
#include <vector>
+#include <string>
-#include "Lsstream.h"
-#include "LString.h"
+namespace lyx {
+namespace support {
///
-int compare_no_case(string const & s, string const & s2);
+int compare_no_case(std::string const & s, std::string const & s2);
///
-int compare_ascii_no_case(string const & s, string const & s2);
+int compare_ascii_no_case(std::string const & s, std::string const & s2);
///
-int compare_no_case(string const & s, string const & s2, unsigned int len);
+int compare_no_case(std::string const & s, std::string const & s2, unsigned int len);
///
inline
}
///
-bool isStrInt(string const & str);
+bool isStrInt(std::string const & str);
-/// does the string represent an unsigned integer value ?
-bool isStrUnsignedInt(string const & str);
+/// does the std::string represent an unsigned integer value ?
+bool isStrUnsignedInt(std::string const & str);
///
-int strToInt(string const & str);
+int strToInt(std::string const & str);
/// convert string to an unsigned integer
-unsigned int strToUnsignedInt(string const & str);
+unsigned int strToUnsignedInt(std::string const & str);
///
-bool isStrDbl(string const & str);
+bool isStrDbl(std::string const & str);
///
-double strToDbl(string const & str);
+double strToDbl(std::string const & str);
///
char lowercase(char c);
char uppercase(char c);
/// same as lowercase(), but ignores locale
-string const ascii_lowercase(string const &);
+std::string const ascii_lowercase(std::string const &);
///
-string const lowercase(string const &);
+std::string const lowercase(std::string const &);
///
-string const uppercase(string const &);
+std::string const uppercase(std::string const &);
-/// convert \a T to string
-template<typename T>
-inline
-string const tostr(T const & t)
-{
- ostringstream ostr;
- ostr << t;
- return ostr.str().c_str();
- // We need to use the .c_str since we sometimes are using
- // our own string class and that is not compatible with
- // basic_string<char>. (of course we don't want this later)
-}
+/// Does the std::string start with this prefix?
+bool prefixIs(std::string const &, std::string const &);
+/// Does the string end with this char?
+bool suffixIs(std::string const &, char);
-///
-template<>
-inline
-string const tostr(bool const & b)
-{
- return (b ? "true" : "false");
-}
+/// Does the std::string end with this suffix?
+bool suffixIs(std::string const &, std::string const &);
///
-template<>
-inline
-string const tostr(string const & s)
+template <typename B>
+bool contains(std::string const & a, B b)
{
- return s;
+ return a.find(b) != std::string::npos;
}
-/// Does the string start with this prefix?
-bool prefixIs(string const &, char const *);
-
-/// Does the string start with this prefix?
-bool prefixIs(string const &, string const &);
-
-/// Does the string end with this char?
-bool suffixIs(string const &, char);
-
-/// Does the string end with this suffix?
-bool suffixIs(string const &, char const *);
-
-/// Does the string end with this suffix?
-bool suffixIs(string const &, string const &);
-
-///
-bool contains(string const & a, string const & b);
-
///
-bool contains(string const & a, char b);
-
-/// This should probably we rewritten to be more general.
-class contains_functor {
-public:
- typedef string first_argument_type;
- typedef string second_argument_type;
- typedef bool result_type;
-
- bool operator()(string const & haystack, string const & needle) const {
- return contains(haystack, needle);
- }
-};
-
-
-///
-bool containsOnly(string const &, string const &);
+bool containsOnly(std::string const &, std::string const &);
/** Extracts a token from this string at the nth delim.
Doesn't modify the original string. Similar to strtok.
token("a;bc;d", ';', 2) == "d";
\endcode
*/
-string const token(string const & a, char delim, int n);
+std::string const token(std::string const & a, char delim, int n);
/** Search a token in this string using the delim.
tokenPos("a;bc;d", ';', "d") == 2;
\endcode
*/
-int tokenPos(string const & a, char delim, string const & tok);
-
+int tokenPos(std::string const & a, char delim, std::string const & tok);
-/** Compares a string and a (simple) regular expression
- The only element allowed is "*" for any string of characters
- */
-bool regexMatch(string const & a, string const & pattern);
/// Substitute all \a oldchar with \a newchar
-string const subst(string const & a, char oldchar, char newchar);
-
-/// Substitutes all instances of \a oldstr with \a newstr
-string const subst(string const & a,
- char const * oldstr, string const & newstr);
+std::string const subst(std::string const & a, char oldchar, char newchar);
/// substitutes all instances of \a oldstr with \a newstr
-string const subst(string const & a,
- string const & oldstr, string const & newstr);
+std::string const subst(std::string const & a,
+ std::string const & oldstr, std::string const & newstr);
/** Trims characters off the end and beginning of a string.
\code
trim("ccabccc", "c") == "ab".
\endcode
*/
-string const trim(string const & a, char const * p = " ");
+std::string const trim(std::string const & a, char const * p = " ");
/** Trims characters off the end of a string.
\code
rtrim("abccc", "c") == "ab".
\endcode
*/
-string const rtrim(string const & a, char const * p = " ");
+std::string const rtrim(std::string const & a, char const * p = " ");
/** Trims characters off the beginning of a string.
\code
ltrim("ababcdef", "ab") = "cdef"
\endcode
*/
-string const ltrim(string const & a, char const * p = " ");
+std::string const ltrim(std::string const & a, char const * p = " ");
/** Splits the string by the first delim.
Splits the string by the first appearance of delim.
s1= ""; s2= "a;bc".split(s1, ';') -> s1 == "a"; s2 == "bc";
\endcode
*/
-string const split(string const & a, string & piece, char delim);
+std::string const split(std::string const & a, std::string & piece, char delim);
/// Same as split but does not return a piece
-string const split(string const & a, char delim);
+std::string const split(std::string const & a, char delim);
/// Same as split but uses the last delim.
-string const rsplit(string const & a, string & piece, char delim);
+std::string const rsplit(std::string const & a, std::string & piece, char delim);
/// Escapes non ASCII chars
-string const escape(string const & lab);
+std::string const escape(std::string const & lab);
/// gives a vector of stringparts which have the delimiter delim
-std::vector<string> const getVectorFromString(string const & str,
- string const & delim = ",");
+std::vector<std::string> const getVectorFromString(std::string const & str,
+ std::string const & delim = std::string(","));
// the same vice versa
-string const getStringFromVector(std::vector<string> const & vec,
- string const & delim = ",");
+std::string const getStringFromVector(std::vector<std::string> const & vec,
+ std::string const & delim = std::string(","));
+
+// wrapper around boost::format using one argument %1$s
+std::string bformat(std::string const & fmt, std::string const & arg1);
+// arguments %1$s and %2$s
+std::string bformat(std::string const & fmt, std::string const & arg1, std::string const & arg2);
+// arguments %1$d and %2$d
+std::string bformat(std::string const & fmt, int arg1, int arg2);
+// arguments %1$s and %2$s and %3$s
+std::string bformat(std::string const & fmt, std::string const & arg1, std::string const & arg2,
+ std::string const & arg3);
+// arguments %1$s and %2$s and %3$s and %4$s
+std::string bformat(std::string const & fmt, std::string const & arg1, std::string const & arg2,
+ std::string const & arg3, std::string const & arg4);
+
+} // namespace support
+} // namespace lyx
#endif
projects / lyx.git / blobdiff