std:: mbrtoc8

定义于头文件 <cuchar>
std:: size_t mbrtoc8 ( char8_t * pc8, const char * s, std:: size_t n, std:: mbstate_t * ps ) ;		(C++20 起)

将窄多字节字符转换为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 的值，该调用等价于 std :: mbrtoc8 ( nullptr, "" , 1 , ps ) 。

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

该函数使用的多字节编码由当前生效的 C 语言区域设置指定。

目录 1 参数 2 返回值 3 示例 4 参见

参数

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

返回值

以下情况中首先适用的条件：

• ​ 0 ​ 如果从 s 转换的字符（若 * pc8 非空则存储其中）是空字符。
• 成功从 s 转换的多字节字符的字节数 [ 1 ... n ] 。
• static_cast < std:: size_t > ( - 3 ) 如果来自由多个代码单元组成的编码字符的下一个 UTF-8 代码单元已写入 * pc8 。此情况下不会处理输入中的任何字节。
• static_cast < std:: size_t > ( - 2 ) 如果接下来的 n 个字节构成一个不完整但迄今为止有效的多字节字符。不会向 * pc8 写入任何内容。
• static_cast < std:: size_t > ( - 1 ) 如果发生编码错误。不会向 * pc8 写入任何内容，值 EILSEQ 将存储于 errno 中，且 * ps 的值未指定。

示例

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

参见

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