命名空间
变体
操作

std::c32rtomb

来自 cppreference.com
< cpp‎ | string‎ | multibyte
定义在头文件 <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