174 lines
4.3 KiB
C++
174 lines
4.3 KiB
C++
/**
|
|
* @file dl_code_cvt.h
|
|
* @brief 编码转换
|
|
*
|
|
|
|
* @version 1.0
|
|
* @author lveyou
|
|
* @date 22-05-16
|
|
*
|
|
* @note 字符编码转换、utf8相关
|
|
* 函数顺序:u8、wc、mb、utf、u16、u32
|
|
* 传参:u8优先使用string、wc优先使用wchar_t
|
|
*/
|
|
#pragma once
|
|
|
|
#include <string>
|
|
|
|
#include "dl_buffer.h"
|
|
//! 字符编码转换
|
|
namespace dl::CodeCvt
|
|
{
|
|
|
|
/**
|
|
* @brief iconv的简单封装,请使用更具体的函数。
|
|
*/
|
|
Buffer CvtString(std::string_view from, std::string_view to, BufferView buf);
|
|
|
|
//! utf8编码
|
|
namespace Utf8
|
|
{
|
|
/**
|
|
* @brief 返回是否是utf-8编码
|
|
* @retval 0 mb
|
|
* @retval 1 ascii(也算utf8编码)
|
|
* @retval 2 utf-8
|
|
*/
|
|
int Check(std::string_view str);
|
|
|
|
/**
|
|
* @brief utf-8的子串计算
|
|
* @param[in] str 源字符串
|
|
* @param[in] max 最大长度
|
|
* @retval 返回应该截断的位置
|
|
*/
|
|
size_t Sub(std::string_view str, size_t max);
|
|
|
|
/**
|
|
* @brief utf-8的安全复制
|
|
* @param[out] target 目标缓冲区
|
|
* @param[in] size 目标缓冲区大小
|
|
* @param[in] source 源字符串
|
|
* @param[in] log 是否输出日志,在源字符串过大时
|
|
*/
|
|
void Copy(char* target, size_t size, std::string_view source, bool show_log = true);
|
|
}
|
|
|
|
//-----------------------------------------------cvt--------------------------------------------
|
|
//! 编码转换缓冲区大小,越大使用更多的内存,但会更快
|
|
constexpr size_t SIZE_BUFFER_STRING_CONVERT = 1024;
|
|
|
|
|
|
|
|
//---------------------------------utf8--------------------------------------------
|
|
/**
|
|
* @brief 字符串转换:utf8 -> 本地编码
|
|
* @param[in] code_page 代码页
|
|
*/
|
|
std::string Utf8ToMultiByte(std::string_view str, std::string_view code_page = "");
|
|
/**
|
|
* @brief 字符串转换:utf8 -> 宽字符
|
|
*/
|
|
std::wstring Utf8ToWideChar(std::string_view str);
|
|
/**
|
|
* @brief 字符串转换:utf8 -> utf32
|
|
*/
|
|
std::u32string Utf8ToUtf32(std::string_view str);
|
|
|
|
//---------------------------------本地编码--------------------------------------------
|
|
/**
|
|
* @brief 字符串转换:本地编码 -> utf8
|
|
* @param[in] code_page 代码页
|
|
*/
|
|
std::string MultiByteToUtf8(std::string_view str, std::string_view code_page = "");
|
|
|
|
/**
|
|
* @brief 字符串转换:本地编码 -> utf8
|
|
* @param[in] code_page 代码页
|
|
*/
|
|
std::string MultiByteToUtf8(const char* str, std::string_view code_page = "");
|
|
|
|
//---------------------------------宽字符--------------------------------------------
|
|
/**
|
|
* @brief 字符串转换:宽字符 -> utf8
|
|
* @param[in] code_page 代码页
|
|
*/
|
|
std::string WideCharToUtf8(std::wstring_view str);
|
|
|
|
//---------------------------------utf32--------------------------------------------
|
|
/**
|
|
* @brief 字符串转换:utf32 -> utf8
|
|
*/
|
|
std::string Utf32ToUtf8(std::u32string_view str);
|
|
|
|
//
|
|
////------------------utf-8---------------------
|
|
///**
|
|
// * @brief 字符串转换:utf-8 -> 宽字符
|
|
//*/
|
|
//std::wstring cvt_u8_wc(string_view str);
|
|
//
|
|
///**
|
|
// * @brief 字符串转换:utf-8 -> 本地编码
|
|
// * @note 此函数只在必须时使用
|
|
//*/
|
|
//string cvt_u8_mb(string_view str);
|
|
//
|
|
///**
|
|
// * @brief 字符串转换:utf_string -> utf-8
|
|
//*/
|
|
//utf_string cvt_u8_utf(string_view str);
|
|
//
|
|
////------------------wstring--------------------
|
|
///**
|
|
// * @brief 字符串转换:宽字符 -> utf-8
|
|
//*/
|
|
//string cvt_wc_u8(const wchar_t* str);
|
|
//string cvt_wc_u8(std::wstring_view str);
|
|
//
|
|
///**
|
|
// * @brief 字符串转换:宽字符 -> 本地编码
|
|
//*/
|
|
//string cvt_wc_mb(const wchar_t* str, string_view code_name = "");
|
|
//
|
|
//
|
|
//
|
|
////------------------本地编码--------------------
|
|
///**
|
|
//* @brief 字符串转换:mb -> utf-8
|
|
//*/
|
|
//string cvt_mb_u8(const char* str, string_view code_name = "");
|
|
//string cvt_mb_u8(string_view str, string_view code_name = "");
|
|
//
|
|
///**
|
|
// * @brief 字符串转换:mb -> wc
|
|
//*/
|
|
//std::wstring cvt_mb_wc(const char* str, string_view code_name = "");
|
|
//
|
|
////------------------未知utf--------------------
|
|
///**
|
|
// * @brief 字符串转换:utf_string -> utf-8
|
|
//*/
|
|
//string cvt_utf_u8(const utf_string& str);
|
|
|
|
//
|
|
//namespace ANSIExtend
|
|
//{
|
|
// /**
|
|
// * @brief gbk编码截断
|
|
// * @param[in] str 源字符串
|
|
// * @param[in] max 最大长度
|
|
// * @retval 返回应该截断的位置
|
|
// */
|
|
// size_t GbkSubIndex(std::string_view str, size_t max);
|
|
//
|
|
// inline std::string_view GbkSub(std::string_view str, size_t max)
|
|
// {
|
|
// return { str.begin(), str.begin() + GbkSubIndex(str, max) };
|
|
// }
|
|
//}
|
|
|
|
}
|
|
|
|
|