mirror of
https://github.com/DarkStore-3DS/Project_CTR.git
synced 2026-07-03 08:49:03 +00:00
jakcron
77 lines
2.1 KiB
C++
77 lines
2.1 KiB
C++
/**
|
|
* @file TranscodeUtil.h
|
|
* @brief Declaration of tc::string::TranscodeUtil
|
|
* @author Jack (jakcron)
|
|
* @version 0.2
|
|
* @date 2020/03/22
|
|
**/
|
|
#pragma once
|
|
#include <string>
|
|
|
|
#include <tc/ArgumentException.h>
|
|
|
|
namespace tc { namespace string {
|
|
|
|
/**
|
|
* @class TranscodeUtil
|
|
* @brief Collection of functions to transcode between UTF-8/UTF-16/UTF-32
|
|
**/
|
|
class TranscodeUtil
|
|
{
|
|
public:
|
|
/**
|
|
* @brief Transcode a UTF-8 string to UTF-32.
|
|
* @param[in] src Source UTF-8 string.
|
|
* @param[out] dst Destination UTF-32 string.
|
|
*
|
|
* @throw tc::ArgumentException When src is an invalid string.
|
|
**/
|
|
static void UTF8ToUTF32(const std::string& src, std::u32string& dst);
|
|
|
|
/**
|
|
* @brief Transcode a UTF-16 string to UTF-32.
|
|
* @param[in] src Source UTF-16 string.
|
|
* @param[out] dst Destination UTF-32 string.
|
|
*
|
|
* @throw tc::ArgumentException When src is an invalid string.
|
|
**/
|
|
static void UTF16ToUTF32(const std::u16string& src, std::u32string& dst);
|
|
|
|
/**
|
|
* @brief Transcode a UTF-32 string to UTF-8.
|
|
* @param[in] src Source UTF-32 string.
|
|
* @param[out] dst Destination UTF-8 string.
|
|
*
|
|
* @throw tc::ArgumentException When src is an invalid string.
|
|
**/
|
|
static void UTF32ToUTF8(const std::u32string& src, std::string& dst);
|
|
|
|
/**
|
|
* @brief Transcode a UTF-32 string to UTF-16.
|
|
* @param[in] src Source UTF-32 string.
|
|
* @param[out] dst Destination UTF-16 string.
|
|
*
|
|
* @throw tc::ArgumentException When src is an invalid string.
|
|
**/
|
|
static void UTF32ToUTF16(const std::u32string& src, std::u16string& dst);
|
|
|
|
/**
|
|
* @brief Transcode a UTF-8 string to UTF-16.
|
|
* @param[in] src Source UTF-8 string.
|
|
* @param[out] dst Destination UTF-16 string.
|
|
*
|
|
* @throw tc::ArgumentException When src is an invalid string.
|
|
**/
|
|
static void UTF8ToUTF16(const std::string& src, std::u16string& dst);
|
|
|
|
/**
|
|
* @brief Transcode a UTF-16 string to UTF-8.
|
|
* @param[in] src Source UTF-16 string.
|
|
* @param[out] dst Destination UTF-8 string.
|
|
*
|
|
* @throw tc::ArgumentException When src is an invalid string.
|
|
**/
|
|
static void UTF16ToUTF8(const std::u16string& src, std::string& dst);
|
|
};
|
|
|
|
}} // namespace tc::string
|