stringutils.h

Go to the documentation of this file.

/*
    Sheep - A Rigid Body Dynamics Engine
    Copyright (C) 2001-2004 Francois Beaune
    Contact: http://toxicengine.sourceforge.net/

    This file is part of Sheep.

    Sheep 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 2 of the License, or
    (at your option) any later version.

    Sheep 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 Sheep; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef SHEEP_MISC_STRINGUTILS_H
#define SHEEP_MISC_STRINGUTILS_H

#include "config.h"

#include <cctype>
#include <cstring>
#include <sstream>
#include <string>

namespace sheep {

    class StringUtils {
    public:
        // General purpose string manipulation functions.

        static std::string ToLower(const std::string &s);
        static std::string ToUpper(const std::string &s);

        //! Returns 0 if the two strings are the same with case-insensitive comparison.
        static int CompareNoCase(const std::string &s1, const std::string &s2);

        struct ConversionErrorException {};

        template<typename T>
        static T FromString(const std::string &s)
            throw(ConversionErrorException);

        template<typename T>
        static std::string ToString(const T &t);

        //! Like non standard function strdup(). Returns a pointer to a
        //! buffer dynamically allocated with new[]. Allocated memory must
        //! be released by the caller using the delete[] operator.
        static char *Replicate(const char *s);

        // Path and filename manipulation functions.
        // Be careful: these functions don't handle properly
        // filenames starting with a dot, like .emacs

        //! Removes leading and trailing blanks (spaces and tabs),
        //! and add a trailing slash if missing.
        static std::string NormalizePath(const std::string &s);

        static std::string GetPath(const std::string &s);
        static std::string GetFilename(const std::string &s);

        static std::string GetExtension(const std::string &s);
        static std::string RemoveExtension(const std::string &s);
    };

#include "stringutils.inl"

}

#endif  // !SHEEP_MISC_STRINGUTILS_H

---