text.h

/*
**  UICore
**  Copyright (c) 1997-2015 The UICore Team
**
**  This software is provided 'as-is', without any express or implied
**  warranty.  In no event will the authors be held liable for any damages
**  arising from the use of this software.
**
**  Permission is granted to anyone to use this software for any purpose,
**  including commercial applications, and to alter it and redistribute it
**  freely, subject to the following restrictions:
**
**  1. The origin of this software must not be misrepresented; you must not
**     claim that you wrote the original software. If you use this software
**     in a product, an acknowledgment in the product documentation would be
**     appreciated but is not required.
**  2. Altered source versions must be plainly marked as such, and must not be
**     misrepresented as being the original software.
**  3. This notice may not be removed or altered from any source distribution.
**
**  Note: Some of the libraries UICore may link to may have additional
**  requirements or restrictions.
**
**  File Author(s):
**
**    Magnus Norddahl
*/

#pragma once

#include <vector>

namespace uicore
{
    enum class ByteOrderMark
    {
        none,
        utf32_be,
        utf32_le,
        utf16_be,
        utf16_le,
        utf8
    };

    class Text
    {
    public:
        static std::vector<std::string> split(const std::string &text, const std::string &split_string, bool skip_empty = true);

        static std::string trim(const std::string &text);

        static std::string remove_trailing_zeros(std::string text);

        static bool equal_caseless(const std::string &a, const std::string &b);

        static bool less_caseless(const std::string &a, const std::string &b);

        static std::string to_upper(const std::string &s);

        static std::string to_lower(const std::string &s);

        static std::string from_wchar(wchar_t value);

        static std::string from_utf32(unsigned int value);

        static std::string from_utf16(const std::wstring &s);

        static std::wstring to_utf16(const std::string &s);

        static std::string to_string(unsigned char value, int base = 10, bool uppercase = false) { return to_string((unsigned int)value, base, uppercase); }
        static std::string to_string(unsigned short value, int base = 10, bool uppercase = false) { return to_string((unsigned int)value, base, uppercase); }
        static std::string to_string(unsigned int value, int base = 10, bool uppercase = false);
        static std::string to_string(unsigned long long value);
        static std::string to_string(char value, int base = 10, bool uppercase = false) { return to_string((int)value, base, uppercase); }
        static std::string to_string(short value, int base = 10, bool uppercase = false) { return to_string((int)value, base, uppercase); }
        static std::string to_string(int value, int base = 10, bool uppercase = false);
        static std::string to_string(long long value);
        static std::string to_string(float value, int digits = 6, bool remove_trailing_zeros = true);
        static std::string to_string(double value, int digits = 6, bool remove_trailing_zeros = true);
        static std::string to_string(bool value);

        static unsigned int parse_uint32(const std::string &value, int base = 10);
        static int parse_int32(const std::string &value, int base = 10);
        static unsigned long long parse_uint64(const std::string &value, int base = 10);
        static long long parse_int64(const std::string &value, int base = 10);
        static float parse_float(const std::string &value);
        static double parse_double(const std::string &value);
        static bool parse_bool(const std::string &value);

        static std::string::size_type char_length(const std::string &str);

        static ByteOrderMark detect_bom(const void *data, std::string::size_type length);
    };
}