std:: wcsrtombs

将指向数组首元素的宽字符序列 * src 转换为其窄多字节表示形式，转换过程始于由 * ps 描述的转换状态。若 dst 非空，则转换后的字符将存储到由 dst 指向的字符数组的连续元素中。最多向目标数组写入 len 个字节。

每个字符的转换如同调用 std::wcrtomb 。满足以下条件时转换停止：

• 空字符已被转换并存储。 src 被设为空指针，且 * ps 表示初始移位状态。
• 发现一个在当前 C 语言区域中不对应有效字符的 wchar_t 。 src 被设置为指向首个未转换的宽字符。
• 待存储的下一个多字节字符将超出 len 的限制。 src 被设置为指向首个未转换的宽字符。若 dst 为空指针则不检查此条件。

参数

返回值

成功时，返回写入到由 dst 指向首元素的字符数组的字节数（包含任何移位序列，但不包括终止符 ' \0 ' ）。若 dst 是空指针，则返回本应写入的字节数（同样不包括终止空字符 ' \0 ' ）。

在转换错误时（如果遇到无效宽字符），返回 static_cast < std:: size_t > ( - 1 ) ，将 EILSEQ 存入 errno ，并使 * ps 处于未指定状态。

示例

#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
#include <vector>
void print_wide(const wchar_t* wstr)
{
    std::mbstate_t state = std::mbstate_t();
    std::size_t len = 1 + std::wcsrtombs(nullptr, &wstr, 0, &state);
    std::vector<char> mbstr(len);
    std::wcsrtombs(&mbstr[0], &wstr, mbstr.size(), &state);
    std::cout << "multibyte string: " << &mbstr[0] << '\n'
              << "Length, including '\\0': " << mbstr.size() << '\n';
}
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const wchar_t* wstr = L"z\u00df\u6c34\U0001d10b"; // or L"zß水𝄋"
    print_wide(wstr);
}

multibyte string: zß水𝄋
Length, including '\0': 11

参见