mbrtoc8
来自 cppreference.cn
| 在头文件 <uchar.h> 中定义 |
||
| (自 C23 起) | ||
将窄多字节字符转换为 UTF-8 编码。
如果 s 不是空指针，则检查多字节字符字符串的最多 n 个字节，从 s 指向的字节开始，以确定完成下一个多字节字符（包括任何移位序列）所需的字节数。如果函数确定 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 字符串转换为窄多字节编码 (function) |
| C++ 文档 用于 mbrtoc8
| |
