转换来自 UTF-8 的单个编码点为窄多字节字符表示。

若 s 不是空指针且 c8 是编码点的合法 UTF-8 编码中的最后编码单元，则函数确定存储该编码点的多字节字符表示所需的字符数（包含任何迁移序列，并且考虑到当前多字节转换状态 *ps ），并存储多字节字符表示于首元素为 s 所指向的字符数组，按需更新 *ps 。此函数至多能写入 MB_CUR_MAX 个字节。

若 c8 不是编码点表示中的最终 UTF-8 编码单元，则函数不写入 s 所指向的数组，只更新 *ps 。

若 s 为空指针，则调用等价于对某内部缓冲区 buf 的 std::c8rtomb(buf, u8'\0', ps) 。

若 c8 为空字符 u8'\0' ，则存储空字节，前附任何恢复初始迁移状态所需的迁移序列，并更新转换状态参数 *ps ，使之代表初始迁移状态。

此函数所用的多字节编码由当前活跃的 C 本地环境指定。

参数

返回值

存储于数组中的的字节数（包含任何迁移序列）。 c8 不是编码点的 UTF-8 表示中的最终编码单元时，可以为零。

若 c8 非法（不贡献到对应合法多字节字符的 char8_t 序列），则存储宏 EILSEQ 的值于 errno ，返回 size_t(-1) ，而转换状态未指定。

注意

以空指针参数 s 调用 c8rtomb ，可能会与其他以空指针参数 s 对 c8rtomb 的调用造成数据竞争。

示例

参阅