// -*- C++ -*-
-
-/*
- 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.
-*/
+/**
+ * \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 "support/docstring.h"
-#include <cstring>
-#include <cctype>
+#include <vector>
-#include "Lsstream.h"
-#include "LString.h"
+namespace lyx {
+namespace support {
+///
+int compare_no_case(std::string const & s, std::string const & s2);
+int compare_no_case(lyx::docstring const & s, lyx::docstring const & s2);
///
-int compare_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_ascii_no_case(docstring const & s, docstring const & s2);
+
+///
+int compare_no_case(std::string const & s, std::string const & s2, unsigned int len);
///
inline
int compare(char const * a, char const * b)
{
+#ifndef CXX_GLOBAL_CSTD
+ return std::strcmp(a, b);
+#else
return strcmp(a, b);
+#endif
}
///
inline
int compare(char const * a, char const * b, unsigned int len)
{
+#ifndef CXX_GLOBAL_CSTD
+ return std::strncmp(a, b, len);
+#else
return strncmp(a, b, len);
+#endif
}
///
-bool isStrInt(string const & str);
+bool isStrInt(std::string const & str);
-///
-int strToInt(string const & str);
+/// does the std::string represent an unsigned integer value ?
+bool isStrUnsignedInt(std::string const & str);
///
-bool isStrDbl(string const & str);
+bool isStrDbl(std::string const & str);
///
-double strToDbl(string const & str);
-
-///
char lowercase(char c);
-///
+///
char uppercase(char c);
+/// changes the case only if c is a one-byte char
+char_type lowercase(char_type c);
+
+/// changes the case only if c is a one-byte char
+char_type uppercase(char_type c);
+
+/// same as lowercase(), but ignores locale
+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 T to string
-template<typename T>
-inline
-string const tostr(T const & t)
-{
- std::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);
+/// Does the std::string end with this suffix?
+bool suffixIs(std::string const &, std::string const &);
///
-inline
-string const tostr(bool b)
+template <typename B>
+bool contains(std::string const & a, B b)
{
- return (b ? "true" : "false");
+ return a.find(b) != std::string::npos;
}
-
-/// Does the string start with this prefix?
-bool prefixIs(string const &, char 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 *);
+template <typename B>
+bool contains(lyx::docstring const & a, B b)
+{
+ return a.find(b) != lyx::docstring::npos;
+}
///
-bool contains(char const * a, string const & b);
+bool containsOnly(std::string const &, std::string const &);
-///
-bool contains(string const & a, char const * b);
+/** Extracts a token from this string at the nth delim.
+ Doesn't modify the original string. Similar to strtok.
+ Example:
+ \code
+ token("a;bc;d", ';', 1) == "bc";
+ token("a;bc;d", ';', 2) == "d";
+ \endcode
+*/
+std::string const token(std::string const & a, char delim, int n);
-///
-bool contains(string const & a, string const & b);
+lyx::docstring const token(lyx::docstring const & a,
+ lyx::char_type delim, int n);
-///
-bool contains(char const * a, char const * b);
+/** Search a token in this string using the delim.
+ Doesn't modify the original string. Returns -1 in case of
+ failure.
+ Example:
+ \code
+ tokenPos("a;bc;d", ';', "bc") == 1;
+ tokenPos("a;bc;d", ';', "d") == 2;
+ \endcode
+*/
+int tokenPos(std::string const & a, char delim, std::string const & tok);
-///
-bool containsOnly(string const &, char const *);
-///
-bool containsOnly(string const &, string const &);
+/// Substitute all \a oldchar with \a newchar
+std::string const subst(std::string const & a, char oldchar, char newchar);
-///
-bool containsOnly(char const *, char const *);
+/// Substitute all \a oldchar with \a newchar
+lyx::docstring const subst(docstring const & a,
+ lyx::char_type oldchar, lyx::char_type newchar);
-///
-bool containsOnly(char const *, string const &);
+/// substitutes all instances of \a oldstr with \a newstr
+std::string const subst(std::string const & a,
+ std::string const & oldstr, std::string const & newstr);
-/// Counts how many of character c there is in a
-unsigned int countChar(string const & a, char c);
+/// substitutes all instances of \a oldstr with \a newstr
+lyx::docstring const subst(lyx::docstring const & a,
+ lyx::docstring const & oldstr, lyx::docstring const & newstr);
-/** Extracts a token from this string at the nth delim.
- Doesn't modify the original string. Similar to strtok.
- Example:
- #"a;bc;d".token(';', 1) == "bc";#
- #"a;bc;d".token(';', 2) == "d";#
+/** Trims characters off the end and beginning of a string.
+ \code
+ trim("ccabccc", "c") == "ab".
+ \endcode
*/
-string const token(string const & a, char delim, int n);
+lyx::docstring const trim(lyx::docstring const & a, char const * p = " ");
+/** Trims characters off the end and beginning of a string.
+ \code
+ trim("ccabccc", "c") == "ab".
+ \endcode
+*/
+std::string const trim(std::string const & a, char const * p = " ");
-/** Search a token in this string using the delim.
- Doesn't modify the original string. Returns -1 in case of
- failure.
- Example:
- #"a;bc;d".tokenPos(';', "bc") == 1;#
- #"a;bc;d".token(';', "d") == 2;#
+/** Trims characters off the end of a string.
+ \code
+ rtrim("abccc", "c") == "ab".
+ \endcode
*/
-int tokenPos(string const & a, char delim, string const & tok);
+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
+*/
+std::string const ltrim(std::string const & a, char const * p = " ");
-/** 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);
+/** Splits the string by the first delim.
+ Splits the string by the first appearance of delim.
+ The leading string up to delim is returned in piece (not including
+ delim), while the original string is cut from after the delimiter.
+ Example:
+ \code
+ s1= ""; s2= "a;bc".split(s1, ';') -> s1 == "a"; s2 == "bc";
+ \endcode
+*/
+std::string const split(std::string const & a, std::string & piece, char delim);
+docstring const split(docstring const & a, docstring & piece, char_type delim);
-/// Substitute all "oldchar"s with "newchar"
-string const subst(string const & a, char oldchar, char newchar);
+/// Same as split but does not return a piece
+std::string const split(std::string const & a, char delim);
-/// Substitutes all instances of oldstr with newstr
-string const subst(string const & a,
- char const * oldstr, string const & newstr);
+/// Same as split but uses the last delim.
+std::string const rsplit(std::string const & a, std::string & piece, char delim);
-/** Strips characters off the end of a string.
- #"abccc".strip('c') = "ab".#
- */
-string const strip(string const & a, char c = ' ');
+/// Escapes non ASCII chars
+std::string const escape(std::string const & lab);
-/** Strips characters of the beginning of a string.
- #"cccba".frontstrip('c') = "ba"#. */
-string const frontStrip(string const & a, char c = ' ');
+/// gives a vector of stringparts which have the delimiter delim
+std::vector<std::string> const getVectorFromString(std::string const & str,
+ std::string const & delim = std::string(","));
-/** Strips characters off the beginning of a string.
- #"ababcdef".frontstrip("ab") = "cdef"# .*/
-string const frontStrip(string const & a, char const * p);
+// the same vice versa
+std::string const getStringFromVector(std::vector<std::string> const & vec,
+ std::string const & delim = std::string(","));
-/** Splits the string by the first delim.
- Splits the string by the first appearance of delim.
- The leading string up to delim is returned in piece (not including
- delim), while the original string is cut from after the delimiter.
- Example:
- #s1= ""; s2= "a;bc".split(s1, ';') -> s1 == "a"; s2 == "bc";#
- */
-string const split(string const & a, string & piece, char delim);
+/// Search \p search_token in \p str and return the position if it is
+/// found, else -1. The last item in \p str must be "".
+int findToken(char const * const str[], std::string const & search_token);
-/// Same as split but does not return a piece
-string const split(string const & a, char delim);
+/// Convert internal line endings to line endings as expected by the OS
+lyx::docstring const externalLineEnding(lyx::docstring const & str);
-/// Same as split but uses the last delim.
-string const rsplit(string const & a, string & piece, char delim);
+/// Convert line endings in any formnat to internal line endings
+lyx::docstring const internalLineEnding(lyx::docstring const & str);
+
+
+#ifdef I_AM_NOT_AFRAID_OF_HEADER_LIBRARIES
+
+#include <boost/format.hpp>
+
+template<class Arg1>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1 arg1)
+{
+ return (boost::basic_format<char_type>(fmt) % arg1).str();
+}
+
+
+template<class Arg1, class Arg2>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1 arg1, Arg2 arg2)
+{
+ return (boost::basic_format<char_type>(fmt) % arg1 % arg2).str();
+}
+
+
+template<class Arg1, class Arg2, class Arg3>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1 arg1, Arg2 arg2, Arg3 arg3)
+{
+ return (boost::basic_format<char_type>(fmt) % arg1 % arg2 % arg3).str();
+}
+
+
+template<class Arg1, class Arg2, class Arg3, class Arg4>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1 arg1, Arg2 arg2, Arg3 arg3, Arg4 arg4)
+{
+ return (boost::basic_format<char_type>(fmt) % arg1 % arg2 % arg3 % arg4).str();
+}
+
+#else
+
+template <class Arg1>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1);
+
+template <class Arg1, class Arg2>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1, Arg2);
+
+template <class Arg1, class Arg2, class Arg3>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1, Arg2, Arg3);
+
+template <class Arg1, class Arg2, class Arg3, class Arg4>
+lyx::docstring bformat(lyx::docstring const & fmt, Arg1, Arg2, Arg3, Arg4);
+
+#endif
+
+} // namespace support
+} // namespace lyx
#endif
projects / lyx.git / blobdiff