Files
2025-09-20 17:51:25 +08:00

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) };
// }
//}
}