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
|