430 lines
18 KiB
C++
430 lines
18 KiB
C++
//
|
|
// SuperTuxKart - a fun racing game with go-kart
|
|
// Copyright (C) 2004-2013 Steve Baker <sjbaker1@airmail.net>,
|
|
// Copyright (C) 2004-2013 Ingo Ruhnke <grumbel@gmx.de>
|
|
// Copyright (C) 2006-2013 SuperTuxKart-Team
|
|
//
|
|
// 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 3
|
|
// 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
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
#ifndef HEADER_STRING_UTILS_HPP
|
|
#define HEADER_STRING_UTILS_HPP
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
#include <sstream>
|
|
#include <irrString.h>
|
|
#include "utils/types.hpp"
|
|
#include "utils/log.hpp"
|
|
|
|
namespace StringUtils
|
|
{
|
|
int versionToInt(const std::string &s);
|
|
|
|
bool hasSuffix(const std::string& lhs, const std::string rhs);
|
|
bool startsWith(const std::string& str, const std::string& prefix);
|
|
|
|
/** Return the filename part of a path */
|
|
std::string getBasename(const std::string& filename);
|
|
|
|
/** Return the path ( i.e. up to the last / ) */
|
|
std::string getPath(const std::string& filename);
|
|
|
|
std::string removeExtension(const std::string& filename);
|
|
std::string getExtension(const std::string& filename);
|
|
|
|
bool notEmpty(const irr::core::stringw& input);
|
|
std::string timeToString(float time);
|
|
std::string toUpperCase(const std::string&);
|
|
std::string toLowerCase(const std::string&);
|
|
std::vector<std::string> split(const std::string& s, char c,
|
|
bool keepSplitChar=false);
|
|
std::vector<irr::core::stringw> split(const irr::core::stringw& s,
|
|
char c, bool keepSplitChar=false);
|
|
std::vector<uint32_t> splitToUInt(const std::string& s, char c,
|
|
bool keepSplitChar=false);
|
|
std::vector<std::string> splitPath(const std::string& path);
|
|
std::string replace(const std::string& other, const std::string& from, const std::string& to);
|
|
|
|
irr::core::stringw decodeFromHtmlEntities(const std::string& input);
|
|
|
|
std::string encodeToHtmlEntities(const irr::core::stringw &output);
|
|
|
|
// ------------------------------------------------------------------------
|
|
template <class T>
|
|
std::string toString (const T& any)
|
|
{
|
|
std::ostringstream oss;
|
|
oss << any ;
|
|
return oss.str();
|
|
} // toString template
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Specialisiation for bools to return 'true' or 'false'*/
|
|
inline std::string toString(const bool& b)
|
|
{
|
|
return (b ? "true" : "false");
|
|
} // toString(bool)
|
|
|
|
// ------------------------------------------------------------------------
|
|
template <class T>
|
|
irr::core::stringw toWString (const T& any)
|
|
{
|
|
std::ostringstream oss;
|
|
oss << any ;
|
|
return oss.str().c_str();
|
|
} // toWString
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Convert the contents in string \a rep to type \a T, if conversion
|
|
fails false is returned and the value of \a x is unchanged, if
|
|
true is returned the conversation was successfull. */
|
|
template <class T>
|
|
bool fromString(const std::string& rep, T& x)
|
|
{
|
|
// Don't modify x" if the conversion fails by using a temp
|
|
T temp;
|
|
std::istringstream iss(rep);
|
|
iss >> temp;
|
|
|
|
if (iss.fail())
|
|
{
|
|
return false;
|
|
}
|
|
else
|
|
{
|
|
x = temp;
|
|
return true;
|
|
}
|
|
} // fromString
|
|
|
|
// ------------------------------------------------------------------------
|
|
/**
|
|
* Replaces the first %s or %i/%d in the string with the first value
|
|
* converted to a string), the 2nd %s or %d with the second value etc.
|
|
* So this is basically a simplified s(n)printf replacement, but doesn't
|
|
* do any fancy formatting (and no type checks either - so you can print
|
|
* a string into a %d field). This is basically a replacement for
|
|
* sprintf (and similar functions), mostly meant for strings that are
|
|
* translated (otherwise just use ostringstream) - since e.g. a
|
|
* translated string like _("Player %s - chose your kart") would
|
|
* be broken into two strings:
|
|
* << _("Player ") << name << _(" - chose your kart")
|
|
* and this is in the best case very confusing for translators (which get
|
|
* to see two strings instead of one sentence, see xgettext manual
|
|
* for why this is a bad idea)
|
|
* In order to accomodate translations even more, you can use formats
|
|
* %0, %1, %2, etc..., where %0 is replaced by the first argument, %1 by
|
|
* the second argument, etc... This allows translated strings to not
|
|
* necessarily insert the words in the same order as in English.
|
|
* \param s String in which all %s or %d are replaced.
|
|
* \param all_vals Value(s) to replace all %s or %d with.
|
|
*/
|
|
std::string insertValues(const std::string &s,
|
|
std::vector<std::string>& all_vals);
|
|
|
|
/** This no-op is useful when using variadic arguments, so that we may
|
|
* support the case with 0 variadic arguments */
|
|
template <class T1>
|
|
T1 insertValues(const T1& s) { return s; }
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Same as above but for wide-strings */
|
|
irr::core::stringw insertValues(const irr::core::stringw &s,
|
|
std::vector<irr::core::stringw>& all_vals);
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Note: the order in which the templates are specified is important, since
|
|
// otherwise some compilers will not find the right template to use.
|
|
|
|
template <class T1, class T2, class T3, class T4, class T5, class T6>
|
|
std::string insertValues(const std::string &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4,
|
|
const T5 &v5,const T6 &v6)
|
|
{
|
|
std::vector<std::string> all_vals;
|
|
std::ostringstream dummy;
|
|
dummy << v1; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v2; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v3; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v4; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v5; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v6; all_vals.push_back(dummy.str());
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v6)
|
|
|
|
// ------------------------------------------------------------------------
|
|
template <class T1, class T2, class T3, class T4, class T5>
|
|
std::string insertValues(const std::string &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4,
|
|
const T5 &v5)
|
|
{
|
|
std::vector<std::string> all_vals;
|
|
std::ostringstream dummy;
|
|
dummy << v1; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v2; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v3; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v4; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v5; all_vals.push_back(dummy.str());
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v5)
|
|
|
|
// ------------------------------------------------------------------------
|
|
template <class T1, class T2, class T3, class T4>
|
|
std::string insertValues(const std::string &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4)
|
|
{
|
|
std::vector<std::string> all_vals;
|
|
std::ostringstream dummy;
|
|
dummy << v1; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v2; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v3; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v4; all_vals.push_back(dummy.str());
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v4)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Shortcut insert_values taking three values, see above for
|
|
* full docs.
|
|
* \param s String in which all %s or %d are replaced.
|
|
* \param v1,v2, v3 Value(s) to replace all %s or %d with.
|
|
*/
|
|
template <class T1, class T2, class T3>
|
|
std::string insertValues(const std::string &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3)
|
|
{
|
|
std::vector<std::string> all_vals;
|
|
std::ostringstream dummy;
|
|
dummy << v1; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v2; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v3; all_vals.push_back(dummy.str());
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v3)
|
|
|
|
// ------------------------------------------------------------------------
|
|
// Note: the order in which the templates are specified is important, since
|
|
// otherwise some compilers will not find the right template to use.
|
|
/** Shortcut insert_values taking three values, see above for
|
|
* full docs.
|
|
* \param s String in which all %s or %d are replaced.
|
|
* \param v1,v2 Value(s) to replace all %s or %d with.
|
|
*/
|
|
template <class T1, class T2>
|
|
std::string insertValues(const std::string &s, const T1 &v1,
|
|
const T2 &v2)
|
|
{
|
|
std::vector<std::string> all_vals;
|
|
std::ostringstream dummy;
|
|
dummy << v1; all_vals.push_back(dummy.str()); dummy.str("");
|
|
dummy << v2; all_vals.push_back(dummy.str()); dummy.str("");
|
|
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, v2)
|
|
// ------------------------------------------------------------------------
|
|
/** Shortcut insert_values taking three values, see above for
|
|
* full docs.
|
|
* \param s String in which all %s, %d are replaced.
|
|
* \param v1 Value to replace.
|
|
*/
|
|
template <class T1>
|
|
std::string insertValues(const std::string &s, const T1 &v1)
|
|
{
|
|
std::vector<std::string> all_vals;
|
|
std::ostringstream dummy;
|
|
dummy << v1; all_vals.push_back(dummy.str()); dummy.str("");
|
|
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2, class T3, class T4, class T5, class T6>
|
|
irr::core::stringw insertValues(const irr::core::stringw &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4,
|
|
const T5 &v5, const T6 &v6)
|
|
{
|
|
std::vector<irr::core::stringw> all_vals;
|
|
all_vals.push_back( irr::core::stringw(v1) );
|
|
all_vals.push_back( irr::core::stringw(v2) );
|
|
all_vals.push_back( irr::core::stringw(v3) );
|
|
all_vals.push_back( irr::core::stringw(v4) );
|
|
all_vals.push_back( irr::core::stringw(v5) );
|
|
all_vals.push_back( irr::core::stringw(v6) );
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v6)
|
|
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2, class T3, class T4, class T5>
|
|
irr::core::stringw insertValues(const irr::core::stringw &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4,
|
|
const T5 &v5)
|
|
{
|
|
std::vector<irr::core::stringw> all_vals;
|
|
all_vals.push_back( irr::core::stringw(v1) );
|
|
all_vals.push_back( irr::core::stringw(v2) );
|
|
all_vals.push_back( irr::core::stringw(v3) );
|
|
all_vals.push_back( irr::core::stringw(v4) );
|
|
all_vals.push_back( irr::core::stringw(v5) );
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v5)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2, class T3, class T4>
|
|
irr::core::stringw insertValues(const irr::core::stringw &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4)
|
|
{
|
|
std::vector<irr::core::stringw> all_vals;
|
|
all_vals.push_back( irr::core::stringw(v1) );
|
|
all_vals.push_back( irr::core::stringw(v2) );
|
|
all_vals.push_back( irr::core::stringw(v3) );
|
|
all_vals.push_back( irr::core::stringw(v4) );
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v4)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2, class T3>
|
|
irr::core::stringw insertValues(const irr::core::stringw &s, const T1 &v1,
|
|
const T2 &v2, const T3 &v3)
|
|
{
|
|
std::vector<irr::core::stringw> all_vals;
|
|
irr::core::stringw dummy;
|
|
all_vals.push_back( irr::core::stringw(v1) );
|
|
all_vals.push_back( irr::core::stringw(v2) );
|
|
all_vals.push_back( irr::core::stringw(v3) );
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, ..., v3)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2>
|
|
irr::core::stringw insertValues(const irr::core::stringw &s, const T1 &v1,
|
|
const T2 &v2)
|
|
{
|
|
std::vector<irr::core::stringw> all_vals;
|
|
all_vals.push_back( irr::core::stringw(v1) );
|
|
all_vals.push_back( irr::core::stringw(v2) );
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1, v2)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1>
|
|
irr::core::stringw insertValues(const irr::core::stringw &s, const T1 &v1)
|
|
{
|
|
std::vector<irr::core::stringw> all_vals;
|
|
all_vals.push_back( irr::core::stringw(v1) );
|
|
return insertValues(s, all_vals);
|
|
} // insertValues(s, v1)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2, class T3, class T4, class T5>
|
|
irr::core::stringw insertValues(const wchar_t* chars, const T1 &v1,
|
|
const T2 &v2, const T3 &v3, const T4 &v4,
|
|
const T5 &v5)
|
|
{
|
|
irr::core::stringw s(chars);
|
|
return insertValues(s, v1, v2, v3, v4, v5);
|
|
} // insertValues(s, v1, ..., v5)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2, class T3>
|
|
irr::core::stringw insertValues(const wchar_t* chars, const T1 &v1,
|
|
const T2 &v2, const T3 &v3)
|
|
{
|
|
irr::core::stringw s(chars);
|
|
return insertValues(s, v1, v2, v3);
|
|
} // insertValues(s, v1, ..., v3)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1, class T2>
|
|
irr::core::stringw insertValues(const wchar_t* chars, const T1 &v1,
|
|
const T2 &v2)
|
|
{
|
|
irr::core::stringw s(chars);
|
|
return insertValues(s, v1, v2);
|
|
} // insertValues(s, v1, v2)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for wide strings */
|
|
template <class T1>
|
|
irr::core::stringw insertValues(const wchar_t* chars, const T1 &v1)
|
|
{
|
|
irr::core::stringw s(chars);
|
|
return insertValues(s, v1);
|
|
} // insertValues(s, v1)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for C strings */
|
|
template <class T1, class T2, class T3>
|
|
std::string insertValues(const char* chars, const T1 &v1,
|
|
const T2 &v2, const T3 &v3)
|
|
{
|
|
std::string s(chars);
|
|
return insertValues(s, v1, v2, v3);
|
|
} // insertValues(s, v1, ..., v3)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for C strings */
|
|
template <class T1, class T2>
|
|
std::string insertValues(const char* chars, const T1 &v1,
|
|
const T2 &v2)
|
|
{
|
|
std::string s(chars);
|
|
return insertValues(s, v1, v2);
|
|
} // insertValues(s, v1, v2)
|
|
|
|
// ------------------------------------------------------------------------
|
|
/** Like the other ones above but for C strings */
|
|
template <class T1>
|
|
std::string insertValues(const char* chars, const T1 &v1)
|
|
{
|
|
std::string s(chars);
|
|
return insertValues(s, v1);
|
|
} // insertValues(s, v1)
|
|
|
|
// ------------------------------------------------------------------------
|
|
template<typename T>
|
|
bool parseString(const char* input, T* output)
|
|
{
|
|
std::istringstream conv(input);
|
|
conv >> *output;
|
|
|
|
// check reading worked correctly and everything was read
|
|
if (conv.fail() || !conv.eof())
|
|
{
|
|
return false;
|
|
}
|
|
return true;
|
|
} // parseString
|
|
|
|
// ------------------------------------------------------------------------
|
|
template<typename T>
|
|
bool parseString(const std::string& input, T* output)
|
|
{
|
|
return parseString(input.c_str(), output);
|
|
} // parseString
|
|
|
|
} // namespace StringUtils
|
|
|
|
#endif
|
|
|
|
/* EOF */
|