std:: c32rtomb

将UTF-32字符转换为其窄多字节表示形式。

如果 s 不是空指针，该函数会确定存储 c32 的多字节字符表示形式所需的字节数（包括任何移位序列，并考虑当前多字节转换状态 * ps ），并将多字节字符表示形式存储在以 s 指向的首元素的字符数组中，同时根据需要更新 * ps 。此函数最多可写入 MB_CUR_MAX 字节。

如果 s 是空指针，该调用等价于 std :: c32rtomb ( buf, U ' \0 ' , ps ) （对于某个内部缓冲区 buf ）。

如果 c32 是空宽字符 U ' \0 ' ，将存储一个空字节，并在其前插入恢复初始移位状态所需的任何移位序列，同时转换状态参数 * ps 将被更新以表示初始移位状态。

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

参数

返回值

成功时，返回写入到以 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ß水🍌"; // 或 z\u00df\u6c34\U0001F34C
    std::cout << "正在处理 " << strv.size() << " 个 UTF-32 代码单元：[ ";
    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) << " 转换为 [ ";
        if (rc != (std::size_t) - 1)
            for (unsigned char c8 : std::string_view{out, rc})
                std::cout << +c8 << ' ';
        std::cout << "]\n";
    }
}

正在处理 4 个 UTF-32 代码单元：[ 0x7a 0xdf 0x6c34 0x1f34c ]
0x7a 转换为 [ 0x7a ]
0xdf 转换为 [ 0xc3 0x9f ]
0x6c34 转换为 [ 0xe6 0xb0 0xb4 ]
0x1f34c 转换为 [ 0xf0 0x9f 0x8d 0x8c ]

参见