stk-code_catmod/src/utils/string_utils.hpp
hikerstk 012f503d60 Added more flexible functions to simulate s(n)printf,
removed more snprintf.


git-svn-id: svn+ssh://svn.code.sf.net/p/supertuxkart/code/trunk/supertuxkart@3058 178a84e3-b1eb-0310-8ba1-8eac791a3b58
2009-01-28 04:43:18 +00:00

146 lines
5.2 KiB
C++

// $Id$
//
// SuperTuxKart - a fun racing game with go-kart
// Copyright (C) 2004 Steve Baker <sjbaker1@airmail.net>,
// Ingo Ruhnke <grumbel@gmx.de>
//
// 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>
namespace StringUtils
{
bool has_suffix(const std::string& lhs, const std::string rhs);
/** Return the filename part of a path */
std::string basename(const std::string& filename);
/** Return the path (i.e. up to the last / */
std::string path(const std::string& filename);
std::string without_extension(const std::string& filename);
std::string extension(const std::string& filename);
template <class T>
std::string to_string (const T& any)
{
std::ostringstream oss;
oss << any ;
return oss.str();
}
/** 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 from_string(const std::string& rep, T& x)
{
// this is necessary so that if "x" is not modified if the conversion fails
T temp;
std::istringstream iss(rep);
iss >> temp;
if (iss.fail())
{
return false;
}
else
{
x = temp;
return true;
}
}
std::string upcase (const std::string&);
std::string downcase (const std::string&);
std::vector<std::string> split(const std::string& s, char c);
// ------------------------------------------------------------------------
/** Overloaded insert_values taking one value, see below for
* full docs.
* \param s String in which all %s or %d are replaced.
* \param v1 Value to replace.
*/
template <class T1>
std::string insert_values(const std::string &s, const T1 &v1)
{
return insert_values(s, v1, "", "");
}
// ------------------------------------------------------------------------
/** Overloaded insert_values taking two values, see below 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 insert_values(const std::string &s, const T1 &v1,
const T2 &v2=0)
{
return insert_values(s, v1, v2, "");
}
// ------------------------------------------------------------------------
/** Replaces the first %s or %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)
* \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 insert_values(const std::string &s, const T1 &v1,
const T2 &v2=0, const T3 &v3=0)
{
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());
std::vector<std::string> sv = StringUtils::split(s, '%');
std::string new_string="";
for(unsigned int i=0; i<sv.size(); i++)
{
if(sv[i][0]=='s' || sv[i][0]=='d')
{
new_string+=all_vals[0]+sv[i].substr(1);
all_vals.erase(all_vals.begin());
}
else
new_string+=sv[i];
}
return new_string;
}
} // namespace StringUtils
#endif
/* EOF */