awtk/docs/manual/utf8.md

78 lines
1.5 KiB
Markdown

## utf8
### 概述
wchar_t和char类型转换接口。
示例:
```c
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));
```
----------------------------------
### 函数
<p id="utf8_methods">
| 函数名称 | 说明 |
| -------- | ------------ |
| <a href="#tk_utf8_from_utf16">tk_\utf8\_from\_utf16</a> | |
| <a href="#tk_utf8_to_utf16">tk\_utf8\_to\_utf16</a> | |
#### utf8\_from\_utf16 函数
-----------------------
* 函数功能:
> <p id="tk_utf8_from_utf16">
将wchar_t类型转换为char类型。
* 函数原型:
```
char* tk_utf8_from_utf16 (const wchar_t* str, const char* out, uint32_t size);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | char* | 值。 |
| str | const wchar\_t* | str。 |
| out | const char* | 返回结果缓冲区。 |
| size | uint32\_t | 缓冲区大小。 |
#### utf8\_from\_utf16 函数
-----------------------
* 函数功能:
> <p id="tk_utf8_to_utf16">
将char类型转换为wchar_t类型。
* 函数原型:
```
wchar_t* tk_utf8_to_utf16 (const char* str, const wchar_t* out, uint32_t size);
```
* 参数说明:
| 参数 | 类型 | 说明 |
| -------- | ----- | --------- |
| 返回值 | wchar\_t* | 值。 |
| str | const char* | str。 |
| out | const wchar\_t* | 返回结果缓冲区。 |
| size | uint32\_t | 缓冲区大小。 |