std::wcsrtombs

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库(C++11)

格式化库(C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

初等数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码识别

text_encoding (C++26)

 

空终止多字节字符串

函数 多字节/宽字符串测试 mblen mbrlen mbsinit 多字节/宽字符串转换 mbtowc mbstowcs btowc mbrtowc mbsrtowcs    wctomb wcstombs wctob wcrtomb wcsrtombs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11)

类型

mbstate_t

宏

MB_LEN_MAX MB_CUR_MAX __STDC_UTF_16__ __STDC_UTF_32__ (C++11)(C++11)

 

在标头 <cwchar> 定义
std::size_t wcsrtombs(char* dst,                        constwchar_t** src,                        std::size_t len,                        std::mbstate_t* ps );

转换来自元素为 *src 所指向的宽字符序列为其窄多字节表示，始于 *ps 所描述的转换状态。若 dst 非空，则存储转换后的字符于 dst 所指向的字符数组的相接元素。不写入多于 len 个字节到目标数组。

如同以调用 std::wcrtomb 转换每个字符。若遇到下列条件则停止转换：

• 转换并存储了空字符 L'\0'。此情况下存储的字节是反迁移序列（若需要）后随 '\0'，设置 *src 为空指针并令 *ps 表示初始迁移状态。
• 找到当前 C 本地环境中不对应合法字符的 wchar_t。设置 *src 指向首个未转换的宽字符。
• 下个多字节字符将超出 len。设置 *src 指向首个未转换的宽字符。若 dst 为空指针则不检查此条件。

参数

dst	-	指向窄字符数组的指针，其中将存储多字节字符
src	-	指向指向空终止宽字符串首元素的指针的指针
len	-	dst 所指向的数组中可用的字节数
ps	-	指向转换状态对象的指针

返回值

成功时，返回写入首元素为 dst 所指向的字符数组的字节数（包含任何迁移序列，但不包含终止 '\0'）。若 dst 为空指针，则返回本会写入的字节数。

转换错误时（若遇到非法宽字符），返回 static_cast<std::size_t>(-1)，存储 EILSEQ 于 errno，并令 *ps 留在未指定状态。

示例

运行此代码

#include <clocale>#include <cwchar>#include <iostream>#include <string>#include <vector>   void print_wide(constwchar_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<<"多字节字符串: "<<&mbstr[0]<<'\n'<<"包括 '\0' 的长度: "<< mbstr.size()<<'\n';}   int main(){std::setlocale(LC_ALL, "en_US.utf8");// UTF-8 窄多字节编码constwchar_t* wstr = L"z\u00df\u6c34\U0001d10b";// 或 L"zß水𝄋" print_wide(wstr);}

输出：

多字节字符串: zß水𝄋 包括 '\0' 的长度: 11

参阅

wcrtomb	给定状态，转换宽字符到其多字节表示 (函数)
mbsrtowcs	给定状态，转换窄多字节字符串到宽字符串 (函数)
do_out [虚]	将字符串从 InternT 转换到 ExternT，例如在写入文件时 (std::codecvt<InternT,ExternT,StateT> 的虚受保护成员函数)
wcsrtombs 的 C 文档