std::c32rtomb
来自 cppreference.com
定义在头文件 <cuchar> 中 |
||
std::size_t c32rtomb( char* s, char32_t c32, std::mbstate_t* ps ); |
(自 C++11 起) | |
将 UTF-32 字符转换为其窄多字节表示形式。
如果 s 不是空指针,则该函数确定存储 c32 的多字节字符表示形式所需的字节数(包括任何移位序列,并考虑到当前多字节转换状态 *ps),并将多字节字符表示形式存储在第一个元素由 s 指向的字符数组中,并根据需要更新 *ps。此函数最多可以写入 MB_CUR_MAX 个字节。
如果 s 是空指针,则该调用等效于 std::c32rtomb(buf, U'\0', ps),其中 buf
是某个内部缓冲区。
如果 c32 是空宽字符 U'\0',则存储一个空字节,前面是任何恢复初始移位状态所需的移位序列,转换状态参数 *ps 更新为表示初始移位状态。
此函数使用当前活动 C 本地化的多字节编码。
内容 |
[编辑] 参数
s | - | 指向将存储多字节字符的窄字符数组的指针 |
c32 | - | 要转换的 32 位字符 |
ps | - | 指向用于解释多字节字符串的转换状态对象的指针 |
[编辑] 返回值
如果成功,则返回写入第一个元素由 s 指向的字符数组的字节数(包括任何移位序列)。此值可以为 0,例如,在处理多 char32_t 字符序列中的第一个 char32_t 时(不会在 UTF-32 中发生)。
如果失败(如果 c32 不是有效的 32 位字符),则返回 -1,将 EILSEQ 存储在 errno 中,并将 *ps 保留在未指定的狀態。
[编辑] 示例
运行此代码
#include <climits> #include <clocale> #include <cuchar> #include <iomanip> #include <iostream> #include <string_view> int main() { std::setlocale(LC_ALL, "en_US.utf8"); std::u32string_view strv = U"zß水🍌"; // or z\u00df\u6c34\U0001F34C std::cout << "Processing " << strv.size() << " UTF-32 code units: [ "; for (char32_t c : strv) std::cout << std::showbase << std::hex << static_cast<int>(c) << ' '; std::cout << "]\n"; std::mbstate_t state{}; char out[MB_LEN_MAX]{}; for (char32_t c : strv) { std::size_t rc = std::c32rtomb(out, c, &state); std::cout << static_cast<int>(c) << " converted to [ "; if (rc != (std::size_t) - 1) for (unsigned char c8 : std::string_view{out, rc}) std::cout << +c8 << ' '; std::cout << "]\n"; } }
输出
Processing 4 UTF-32 code units: [ 0x7a 0xdf 0x6c34 0x1f34c ] 0x7a converted to [ 0x7a ] 0xdf converted to [ 0xc3 0x9f ] 0x6c34 converted to [ 0xe6 0xb0 0xb4 ] 0x1f34c converted to [ 0xf0 0x9f 0x8d 0x8c ]
[编辑] 参见
(C++11) |
将窄多字节字符转换为 UTF-32 编码 (函数) |
[虚函数] |
将字符串从 InternT 转换为 ExternT ,例如在写入文件时( std::codecvt<InternT,ExternT,StateT> 的虚保护成员函数) |
C 文档 for c32rtomb
|