xrb_util.hpp

// ///////////////////////////////////////////////////////////////////////////
// xrb_util.hpp by Victor Dods, created 2005/02/05
// ///////////////////////////////////////////////////////////////////////////
// Unless a different license was explicitly granted in writing by the
// copyright holder (Victor Dods), this software is freely distributable under
// the terms of the GNU General Public License, version 2.  Any works deriving
// from this work must also be released under the GNU GPL.  See the included
// file LICENSE for details.
// ///////////////////////////////////////////////////////////////////////////

#if !defined(_XRB_UTIL_HPP_)
#define _XRB_UTIL_HPP_

#include "xrb.hpp"

#include <stdlib.h>
#include <string>

#include "xrb_enums.hpp"

namespace Xrb
{

namespace Util
{
    void ReplaceAllInString (
        std::string *string,
        std::string const &string_to_replace,
        std::string const &string_to_replace_with);
    std::string StringPrintf (char const *format, ...);
    void StringPrintf (std::string *string, char const *format, ...);
    /*
    void StringCopy (
        char *destination,
        char const *source,
        Uint32 destination_size);
    */
    char *StringDuplicate (char const *string_to_duplicate);
    char Lowercase (char c);
    char Uppercase (char c);
    void MakeLowercase (std::string *str);
    void MakeUppercase (std::string *str);
    char ShiftedAscii (char c);

    bool CharacterLiteralCharNeedsEscaping (char c);
    bool StringLiteralCharNeedsEscaping (char c);
    char EscapeCode (char c);
    char EscapedChar (char c);

    std::string CharacterLiteral (char c);
    std::string StringLiteral (std::string const &text);

    template <typename Sint>
    Sint TextToSint (char const *const text)
    {
        return static_cast<Sint>(strtol(text, NULL, 10));
    }
    template <typename Uint>
    Uint TextToUint (char const *const text)
    {
        return static_cast<Uint>(strtoul(text, NULL, 10));
    }
    inline Float TextToFloat (char const *const text)
    {
    #if defined(WIN32)
        return static_cast<Float>(strtod(text, NULL));
    #else
        return strtof(text, NULL);
    #endif
    }
    inline Float TextToFloat (char const *const text, char const **const end)
    {
        // the const_cast BS is because strtof/d's second parameter type is wrong
    #if defined(WIN32)
        return static_cast<Float>(strtod(text, const_cast<char **>(end)));
    #else
        return strtof(text, const_cast<char **>(end));
    #endif
    }

    char const *IOErrorString (IOError error);

    std::string DirectoryPortion (std::string const &path);
    std::string FilenamePortion (std::string const &path);
} // end of namespace Util

} // end of namespace Xrb

#endif // !defined(_XRB_UTIL_HPP_)

---