命名空间
变体
操作

std::wcstombs

来自 cppreference.com
< cpp‎ | string‎ | multibyte
定义在头文件 <cstdlib>
std::size_t wcstombs( char* dst, const wchar_t* src, std::size_t len );

将由 src 指向的数组的第一个元素指向的宽字符序列转换为其以初始移位状态开始的窄多字节表示形式。转换后的字符存储在由 dst 指向的 char 数组的后续元素中。写入目标数组的字节数不超过 len

每个字符都像调用 std::wctomb 一样进行转换,除了 wctomb 的转换状态不受影响。转换在以下情况下停止:

  • 空字符已转换并存储。
  • 发现一个 wchar_t,它在当前 C 区域设置中不对应于有效字符。
  • 要存储的下一个多字节字符将超过 len

内容

[编辑] 注释

在大多数实现中,此函数在处理字符串时会更新类型为 std::mbstate_t 的全局静态对象,并且不能同时被两个线程调用,在这种情况下,应该使用 std::wcsrtombs

POSIX 指定了一个通用扩展:如果 dst 是空指针,则此函数返回将写入 dst 的字节数,如果转换成功。类似的行为对于 std::wcsrtombs 也是标准的。

[编辑] 参数

dst - 指向将存储多字节字符的窄字符数组的指针
src - 指向要转换的以空字符结尾的宽字符串的第一个元素的指针
len - 由 dst 指向的数组中可用的字节数

[编辑] 返回值

成功时,返回写入以 dst 指向的字符数组的字节数(包括任何移位序列,但不包括终止的 '\0')。

发生转换错误时(如果遇到无效的宽字符),返回 static_cast<std::size_t>(-1)

[编辑] 示例

#include <clocale>
#include <cstdlib>
#include <iostream>
 
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ß水𝄋"
    char mbstr[11];
    std::wcstombs(mbstr, wstr, 11);
    std::cout << "multibyte string: " << mbstr << '\n';
}

输出

multibyte string: zß水𝄋

[编辑] 另请参见

将宽字符串转换为窄多字节字符字符串,给出状态
(函数) [编辑]
将窄多字节字符字符串转换为宽字符串
(函数) [编辑]
[虚拟]
将字符串从 InternT 转换为 ExternT,例如写入文件时
(std::codecvt<InternT,ExternT,StateT> 的虚拟受保护成员函数) [编辑]
C 文档 for wcstombs