命名空间
变体
操作

mbrtoc8

来自 cppreference.cn
< c‎ | string‎ | multibyte
定义于头文件 <uchar.h>
size_t mbrtoc8( char8_t* restrict pc8, const char* restrict s, size_t n,
                mbstate_t* restrict ps );
(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 是空指针,则忽略 npc8 的值,并且调用等效于 mbrtoc8(nullptr, "", 1, ps)

如果生成的 UTF-8 代码单元是 u8'\0',则转换状态 *ps 表示初始移位状态。

此函数使用的多字节编码由当前活动的 C 语言环境指定。

目录

[编辑] 参数

pc8 - 指向将要写入结果 UTF-8 代码单元的位置的指针
s - 指向用作输入的多字节字符字符串的指针
n - 可以检查的 s 中的字节数的限制
ps - 指向用于解释多字节字符串的转换状态对象的指针

[编辑] 返回值

以下首个适用项

  • 0 如果从 s 转换而来(如果非空,则存储在 *pc8 中)的字符为空字符。
  • 成功从 s 转换的多字节字符的字节数 [1n]
  • (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 函数

[编辑] 参见

将 UTF-8 字符串转换为窄多字节编码
(函数) [编辑]
C++ 文档 for mbrtoc8