yyc12345
1ccea1290e
- add documentation for win fct helper - add new macro YYCC_U8_CHAR for casting ordinary char to yycc utf8 char. - add documentation for new added YYCC_U8_CHAR.
96 lines
4.1 KiB
C++
96 lines
4.1 KiB
C++
#pragma once
|
|
#include "YYCCInternal.hpp"
|
|
|
|
#include <string>
|
|
|
|
#if YYCC_OS == YYCC_OS_WINDOWS
|
|
#include "WinImportPrefix.hpp"
|
|
#include <Windows.h>
|
|
#include "WinImportSuffix.hpp"
|
|
#endif
|
|
|
|
/**
|
|
* @brief The helper for all encoding aspects.
|
|
* @details
|
|
* For more infomations about how to use the functions provided by this namespace,
|
|
* please see \ref library_encoding and \ref encoding_helper.
|
|
*/
|
|
namespace YYCC::EncodingHelper {
|
|
|
|
#define _YYCC_U8(strl) u8 ## strl ///< The assistant macro for YYCC_U8.
|
|
#define YYCC_U8(strl) (reinterpret_cast<const ::YYCC::yycc_char8_t*>(_YYCC_U8(strl))) ///< The macro for creating UTF8 string literal. See \ref library_encoding.
|
|
#define YYCC_U8_CHAR(chr) (static_cast<YYCC::yycc_char8_t>(chr)) ///< The macro for casting normal char into YYCC UTF8 char type.
|
|
|
|
const yycc_char8_t* ToUTF8(const char* src);
|
|
yycc_char8_t* ToUTF8(char* src);
|
|
yycc_u8string ToUTF8(const std::string_view& src);
|
|
yycc_u8string_view ToUTF8View(const std::string_view& src);
|
|
|
|
const char* ToOrdinary(const yycc_char8_t* src);
|
|
char* ToOrdinary(yycc_char8_t* src);
|
|
std::string ToOrdinary(const yycc_u8string_view& src);
|
|
std::string_view ToOrdinaryView(const yycc_u8string_view& src);
|
|
|
|
#if YYCC_OS == YYCC_OS_WINDOWS
|
|
|
|
bool WcharToChar(const std::wstring_view& src, std::string& dst, UINT code_page);
|
|
bool WcharToChar(const wchar_t* src, std::string& dst, UINT code_page);
|
|
std::string WcharToChar(const std::wstring_view& src, UINT code_page);
|
|
std::string WcharToChar(const wchar_t* src, UINT code_page);
|
|
|
|
bool CharToWchar(const std::string_view& src, std::wstring& dst, UINT code_page);
|
|
bool CharToWchar(const char* src, std::wstring& dst, UINT code_page);
|
|
std::wstring CharToWchar(const std::string_view& src, UINT code_page);
|
|
std::wstring CharToWchar(const char* src, UINT code_page);
|
|
|
|
bool CharToChar(const std::string_view& src, std::string& dst, UINT src_code_page, UINT dst_code_page);
|
|
bool CharToChar(const char* src, std::string& dst, UINT src_code_page, UINT dst_code_page);
|
|
std::string CharToChar(const std::string_view& src, UINT src_code_page, UINT dst_code_page);
|
|
std::string CharToChar(const char* src, UINT src_code_page, UINT dst_code_page);
|
|
|
|
|
|
bool WcharToUTF8(const std::wstring_view& src, yycc_u8string& dst);
|
|
bool WcharToUTF8(const wchar_t* src, yycc_u8string& dst);
|
|
yycc_u8string WcharToUTF8(const std::wstring_view& src);
|
|
yycc_u8string WcharToUTF8(const wchar_t* src);
|
|
|
|
bool UTF8ToWchar(const yycc_u8string_view& src, std::wstring& dst);
|
|
bool UTF8ToWchar(const yycc_char8_t* src, std::wstring& dst);
|
|
std::wstring UTF8ToWchar(const yycc_u8string_view& src);
|
|
std::wstring UTF8ToWchar(const yycc_char8_t* src);
|
|
|
|
bool CharToUTF8(const std::string_view& src, yycc_u8string& dst, UINT code_page);
|
|
bool CharToUTF8(const char* src, yycc_u8string& dst, UINT code_page);
|
|
yycc_u8string CharToUTF8(const std::string_view& src, UINT code_page);
|
|
yycc_u8string CharToUTF8(const char* src, UINT code_page);
|
|
|
|
bool UTF8ToChar(const yycc_u8string_view& src, std::string& dst, UINT code_page);
|
|
bool UTF8ToChar(const yycc_char8_t* src, std::string& dst, UINT code_page);
|
|
std::string UTF8ToChar(const yycc_u8string_view& src, UINT code_page);
|
|
std::string UTF8ToChar(const yycc_char8_t* src, UINT code_page);
|
|
|
|
#endif
|
|
|
|
bool UTF8ToUTF16(const yycc_u8string_view& src, std::u16string& dst);
|
|
bool UTF8ToUTF16(const yycc_char8_t* src, std::u16string& dst);
|
|
std::u16string UTF8ToUTF16(const yycc_u8string_view& src);
|
|
std::u16string UTF8ToUTF16(const yycc_char8_t* src);
|
|
|
|
bool UTF16ToUTF8(const std::u16string_view& src, yycc_u8string& dst);
|
|
bool UTF16ToUTF8(const char16_t* src, yycc_u8string& dst);
|
|
yycc_u8string UTF16ToUTF8(const std::u16string_view& src);
|
|
yycc_u8string UTF16ToUTF8(const char16_t* src);
|
|
|
|
|
|
bool UTF8ToUTF32(const yycc_u8string_view& src, std::u32string& dst);
|
|
bool UTF8ToUTF32(const yycc_char8_t* src, std::u32string& dst);
|
|
std::u32string UTF8ToUTF32(const yycc_u8string_view& src);
|
|
std::u32string UTF8ToUTF32(const yycc_char8_t* src);
|
|
|
|
bool UTF32ToUTF8(const std::u32string_view& src, yycc_u8string& dst);
|
|
bool UTF32ToUTF8(const char32_t* src, yycc_u8string& dst);
|
|
yycc_u8string UTF32ToUTF8(const std::u32string_view& src);
|
|
yycc_u8string UTF32ToUTF8(const char32_t* src);
|
|
|
|
}
|