mbrtoc8

定义于头文件 <uchar.h>
size_t mbrtoc8 ( char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps ) ;		(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 语言区域设置指定。

目录 1 参数 2 返回值 3 示例 4 参考文献 5 另请参阅

参数

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 的值未指定。

示例

本节内容不完整 原因：缺少示例

参考文献

参见

c8rtomb (C23)	将UTF-8字符串转换为窄多字节编码 (函数)
C++ documentation for mbrtoc8