std::c8rtomb
定义于头文件 <cuchar>
|
||
std::size_t c8rtomb( char* s, char8_t c8, std::mbstate_t* ps ); |
(C++20 起) | |
转换来自 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 本地环境指定。
参数
s | - | 指向将要存储多字节字符的通常字符数组的指针 |
c8 | - | 要转换的 UTF-8 编码单元 |
ps | - | 指向转译多字节字符串时使用的转换状态的指针 |
返回值
存储于数组中的的字节数(包含任何迁移序列)。 c8 不是编码点的 UTF-8 表示中的最终编码单元时,可以为零。
若 c8 非法(不贡献到对应合法多字节字符的 char8_t 序列),则存储宏 EILSEQ 的值于 errno ,返回 size_t(-1)
,而转换状态未指定。
注意
以空指针参数 s 调用 c8rtomb
,可能会与其他以空指针参数 s 对 c8rtomb
的调用造成数据竞争。
示例
本节未完成 原因:暂无示例 |
参阅
(C++20) |
转换窄多字节字符为 UTF-8 编码 (函数) |