std:: wcrtomb

将宽字符转换为其窄多字节表示形式。

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

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

若wc是空宽字符 L ' \0 ' ，将存储空字节，并在其前添加恢复初始移位状态所需的任何移位序列，同时转换状态参数 * ps 将被更新以表示初始移位状态。

参数

返回值

成功时，返回写入到以 s 所指向首元素的字符数组的字节数（包含任何移位序列）。

当失败时（如果 wc 不是有效的宽字符），返回 static_cast < std:: size_t > ( - 1 ) ，将 EILSEQ 存入 errno ，并使 * ps 处于未指定状态。

示例

#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
void print_wide(const std::wstring& wstr)
{
    std::mbstate_t state{};
    for (wchar_t wc : wstr)
    {
        std::string mb(MB_CUR_MAX, '\0');
        std::size_t ret = std::wcrtomb(&mb[0], wc, &state);
        std::cout << "multibyte char " << mb << " is " << ret << " bytes\n";
    }
}
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    std::wstring wstr = L"z\u00df\u6c34\U0001f34c"; // 或 L"zß水🍌"
    print_wide(wstr);
}

multibyte char z is 1 bytes
multibyte char ß is 2 bytes
multibyte char 水 is 3 bytes
multibyte char 🍌 is 4 bytes

参见