mbrtoc8
来自 cppreference.cn
| 定义于头文件 <uchar.h> |
||
| (since C23) | ||
将窄多字节字符转换为 UTF-8 编码。
如果 s 不是空指针，则检查以 s 指向的字节开始的多字节字符字符串，最多检查 n 个字节，以确定完成下一个多字节字符所需的字节数（包括任何移位序列）。如果函数确定 s 中的下一个多字节字符是完整且有效的，则将其转换为 UTF-8，并将第一个 UTF-8 代码单元存储在 *pc8 中（如果 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 标准 (ISO/IEC 9899:2024)
- 7.30.1.1 mbrtoc8 函数
[编辑] 参见
| (C23) |
将 UTF-8 字符串转换为窄多字节编码 (函数) |
| C++ 文档 for mbrtoc8
| |
