awtk/docs/manual/utf8_t.md

utf8_t

概述

wchar_t和char类型转换接口。

示例：

const char* str = "hello";
const wchar_t* wstr = L"hello";
char res_str[128];
wchar_t res_wstr[128];

tk_utf8_to_utf16(str, res_wstr, ARRAY_SIZE(res_wstr));
tk_utf8_from_utf16(wstr, res_str, ARRAY_SIZE(res_str));

---

函数

函数名称	说明
tk_utf8_dup_utf16	把ucs字符串转成UTF8字符串。
tk_utf8_from_utf16	把ucs字符串转成UTF8字符串。
tk_utf8_from_utf16_ex	把ucs字符串转成UTF8字符串。
tk_utf8_get_bytes_of_leading	获取第一个字节为c的字符的字节数。
tk_utf8_to_utf16	将char类型转换为wchar_t类型。
tk_utf8_to_utf16_ex	将char类型转换为wchar_t类型。
tk_utf8_trim_invalid_char	如果字符串最后一个字符串是无效的，删掉该无效字符。

tk_utf8_dup_utf16 函数

---

• 函数功能：

把ucs字符串转成UTF8字符串。 由调用者释放返回的指针。

• 函数原型：

char* tk_utf8_dup_utf16 (const wchar_t* in, int32_t size);

• 参数说明：

参数	类型	说明
返回值	char*	返回UTF8字符串。
in	const wchar_t*	输入字符串。
size	int32_t	字符串长度。

tk_utf8_from_utf16 函数

---

• 函数功能：

把ucs字符串转成UTF8字符串。

• 函数原型：

char* tk_utf8_from_utf16 (const wchar_t* in, char* out, uint32_t out_size);

• 参数说明：

参数	类型	说明
返回值	char*	返回UTF8字符串。
in	const wchar_t*	输入字符串。
out	char*	输出字符串。
out_size	uint32_t	输出字符串的最大长度。

tk_utf8_from_utf16_ex 函数

---

• 函数功能：

把ucs字符串转成UTF8字符串。

• 函数原型：

char* tk_utf8_from_utf16_ex (const wchar_t* in, uint32_t in_size, char* out, uint32_t out_size);

• 参数说明：

参数	类型	说明
返回值	char*	返回UTF8字符串。
in	const wchar_t*	输入字符串。
in_size	uint32_t	输入字符串的长度。
out	char*	输出字符串。
out_size	uint32_t	输出字符串的最大长度。

tk_utf8_get_bytes_of_leading 函数

---

• 函数功能：

获取第一个字节为c的字符的字节数。

• 函数原型：

uint32_t tk_utf8_get_bytes_of_leading (uint8_t c);

• 参数说明：

参数	类型	说明
返回值	uint32_t	返回字符的字节数。
c	uint8_t	字符的第一个字节。

tk_utf8_to_utf16 函数

---

• 函数功能：

将char类型转换为wchar_t类型。

• 函数原型：

wchar_t* tk_utf8_to_utf16 (const char* str, wchar_t* out, uint32_t out_size);

• 参数说明：

参数	类型	说明
返回值	wchar_t*	值。
str	const char*	str。
out	wchar_t*	返回结果缓冲区。
out_size	uint32_t	缓冲区大小。

tk_utf8_to_utf16_ex 函数

---

• 函数功能：

将char类型转换为wchar_t类型。

• 函数原型：

wchar_t* tk_utf8_to_utf16_ex (const char* str, uint32_t size, wchar_t* out, uint32_t out_size);

• 参数说明：

参数	类型	说明
返回值	wchar_t*	值。
str	const char*	str。
size	uint32_t	缓冲区大小。
out	wchar_t*	返回结果缓冲区。
out_size	uint32_t	缓冲区大小。

tk_utf8_trim_invalid_char 函数

---

• 函数功能：

如果字符串最后一个字符串是无效的，删掉该无效字符。

对于用strncpy/snprintf等生成字符串时，如果目标字符串内存大小不够， 可能最后一个字符被从中间截断，导致该字符是无效的，这可能会触发assert， 本函数可以用来删除最后一个无效字符。

• 函数原型：

char* tk_utf8_trim_invalid_char (char* str);

• 参数说明：

参数	类型	说明
返回值	char*	返回UTF8字符串。
str	char*	输入字符串。