libeiskaltdcpp-dev 2.2.9-3 / usr / include / eiskaltdcpp / dcpp / Text.h

/*
 * Copyright (C) 2001-2012 Jacek Sieka, arnetheduck on gmail point com
 *
 * 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 2 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 */

#pragma once

#include "debug.h"
#include "typedefs.h"
#include "noexcept.h"

namespace dcpp {

/**
 * Text handling routines for DC++. DC++ internally uses UTF-8 for
 * (almost) all string:s, hence all foreign text must be converted
 * appropriately...
 * acp - ANSI code page used by the system
 * wide - wide unicode string
 * utf8 - UTF-8 representation of the string
 * t - current GUI text format
 * string - UTF-8 string (most of the time)
 * wstring - Wide string
 * tstring - GUI type string (acp string or wide string depending on build type)
 */
namespace Text {
    extern const string utf8;
    extern string systemCharset;
    extern string hubDefaultCharset;

    void initialize();

    const string& acpToUtf8(const string& str, string& tmp) noexcept;
    inline string acpToUtf8(const string& str) noexcept {
        string tmp;
        return acpToUtf8(str, tmp);
    }

    const wstring& acpToWide(const string& str, wstring& tmp) noexcept;
    inline wstring acpToWide(const string& str) noexcept {
        wstring tmp;
        return acpToWide(str, tmp);
    }

    const string& utf8ToAcp(const string& str, string& tmp) noexcept;
    inline string utf8ToAcp(const string& str) noexcept {
        string tmp;
        return utf8ToAcp(str, tmp);
    }

    const wstring& utf8ToWide(const string& str, wstring& tmp) noexcept;
    inline wstring utf8ToWide(const string& str) noexcept {
        wstring tmp;
        return utf8ToWide(str, tmp);
    }

    const string& wideToAcp(const wstring& str, string& tmp) noexcept;
    inline string wideToAcp(const wstring& str) noexcept {
        string tmp;
        return wideToAcp(str, tmp);
    }

    const string& wideToUtf8(const wstring& str, string& tmp) noexcept;
    inline string wideToUtf8(const wstring& str) noexcept {
        string tmp;
        return wideToUtf8(str, tmp);
    }

    int utf8ToWc(const char* str, wchar_t& c);
    void wcToUtf8(wchar_t c, string& str);

#ifdef UNICODE
    inline const tstring& toT(const string& str, tstring& tmp) noexcept { return utf8ToWide(str, tmp); }
    inline tstring toT(const string& str) noexcept { return utf8ToWide(str); }

    inline const string& fromT(const tstring& str, string& tmp) noexcept { return wideToUtf8(str, tmp); }
    inline string fromT(const tstring& str) noexcept { return wideToUtf8(str); }
#else
    inline const tstring& toT(const string& str, tstring& tmp) noexcept { return utf8ToAcp(str, tmp); }
    inline tstring toT(const string& str) noexcept { return utf8ToAcp(str); }

    inline const string& fromT(const tstring& str, string& tmp) noexcept { return acpToUtf8(str, tmp); }
    inline string fromT(const tstring& str) noexcept { return acpToUtf8(str); }
#endif

    inline const TStringList& toT(const StringList& lst, TStringList& tmp) noexcept {
        for(StringIterC i = lst.begin(), iend = lst.end(); i != iend; ++i)
            tmp.push_back(toT(*i));
        return tmp;
    }

    inline const StringList& fromT(const TStringList& lst, StringList& tmp) noexcept {
        for(TStringIterC i = lst.begin(), iend = lst.end(); i != iend; ++i)
            tmp.push_back(fromT(*i));
        return tmp;
    }

    inline bool isAscii(const string& str) noexcept { return isAscii(str.c_str()); }
    bool isAscii(const char* str) noexcept;

    bool validateUtf8(const string& str) noexcept;

    inline char asciiToLower(char c) { dcassert((((uint8_t)c) & 0x80) == 0); return (char)tolower(c); }

    wchar_t toLower(wchar_t c) noexcept;

    const wstring& toLower(const wstring& str, wstring& tmp) noexcept;
    inline wstring toLower(const wstring& str) noexcept {
        wstring tmp;
        return toLower(str, tmp);
    }

    const string& toLower(const string& str, string& tmp) noexcept;
    inline string toLower(const string& str) noexcept {
        string tmp;
        return toLower(str, tmp);
    }

    const string& convert(const string& str, string& tmp, const string& fromCharset, const string& toCharset) noexcept;
    inline string convert(const string& str, const string& fromCharset, const string& toCharset) noexcept {
        string tmp;
        return convert(str, tmp, fromCharset, toCharset);
    }

    const string& toUtf8(const string& str, const string& fromCharset, string& tmp) noexcept;
    inline string toUtf8(const string& str, const string& fromCharset = systemCharset) {
        string tmp;
        return toUtf8(str, fromCharset, tmp);
    }

    const string& fromUtf8(const string& str, const string& toCharset, string& tmp) noexcept;
    inline string fromUtf8(const string& str, const string& toCharset = systemCharset) noexcept {
        string tmp;
        return fromUtf8(str, toCharset, tmp);
    }

    string toDOS(string tmp);
    wstring toDOS(wstring tmp);

}

} // namespace dcpp