mbrtoc8
来自 cppreference.com
| 在头文件 <uchar.h> 中定义 |
||
| (自 C23 起) | ||
将窄多字节字符转换为 UTF-8 编码。
如果 s 不是空指针，则检查最多 n 个字节的多字节字符字符串，从 s 指向的字节开始，以确定完成下一个多字节字符所需的字节数（包括任何移位序列）。如果该函数确定 s 中的下一个多字节字符是完整且有效的，则将其转换为 UTF-8 并在 *pc8 中存储第一个 UTF-8 代码单元（如果 pc8 不是空）。
如果 *s 中的多字节字符的 UTF-8 编码包含多个 UTF-8 代码单元，则在第一次调用此函数后，*ps 会更新，以便下次调用 mbrtoc8 将写入额外的 UTF-8 代码单元，而无需考虑 *s。
如果 s 是空指针，则 n 和 pc8 的值将被忽略，并且调用等效于 mbrtoc8(nullptr, "", 1, ps).
如果生成的 UTF-8 代码单元是 u8'\0'，则转换状态 *ps 表示初始移位状态。
此函数使用的多字节编码由当前活动 C 本地化指定。
内容 |
[编辑] 参数
| pc8 | - | 指向结果 UTF-8 代码单元将写入的位置的指针 |
| s | - | 指向用作输入的多字节字符字符串的指针 |
| n | - | s 中可以检查的字节数的限制 |
| ps | - | 指向在解释多字节字符串时使用的转换状态对象的指针 |
[编辑] 返回值
以下第一个适用的值
- 0 如果从
s转换的字符（如果非空，则存储在 *pc8 中）是空字符 - 从
s成功转换的多字节字符的字节数 [1...n] - (size_t)-3 如果来自编码包含多个代码单元的字符的下一个 UTF-8 代码单元现在已写入 *pc8。在这种情况下，不会从输入中处理任何字节。
- (size_t)-2 如果下一个
n个字节构成了一个不完整的，但到目前为止有效的，多字节字符。不会写入任何内容到 *pc8。 - (size_t)-1 如果发生编码错误。不会写入任何内容到
*pc8，值 EILSEQ 将存储在 errno 中，并且 *ps 的值是不确定的。
[编辑] 示例
| 本节不完整 原因：没有示例 |
[编辑] 参见
| (C23) |
将 UTF-8 字符串转换为窄多字节编码 (函数) |
| C++ 文档 针对 mbrtoc8
| |
