std::mbstowcs
来自 cppreference.com
| 定义在头文件 <cstdlib> 中 |
||
| std::size_t mbstowcs( wchar_t* dst, const char* src, std::size_t len ); |
||
将由 src 指向的第一个元素为其的数组中的多字节字符字符串转换为其宽字符表示形式。 转换后的字符存储在由 dst 指向的数组的后续元素中。 最多将 len 个宽字符写入目标数组。
每个字符都像调用 std::mbtowc 一样进行转换，只是 mbtowc 转换状态不受影响。 转换在以下情况下停止
- 多字节空字符已转换并存储。
- 遇到无效（在当前 C 本地化中）多字节字符。
- 要存储的下一个宽字符将超过 len。
内容 |
[编辑] 注释
在大多数实现中，此函数在处理字符串时会更新类型为 std::mbstate_t 的全局静态对象，并且不能被两个线程同时调用，在这种情况下应该使用 std::mbsrtowcs。
POSIX 指定了一个常见扩展：如果 dst 是一个空指针，此函数将返回将写入 dst 的宽字符数（如果转换）。 类似的行为是 std::mbsrtowcs 的标准。
[编辑] 参数
| dst | - | 指向宽字符数组的指针，宽字符串将存储在此处 |
| src | - | 指向要转换的以空字符结尾的多字节字符串的第一个元素的指针 |
| len | - | dst 指向的数组中可用的宽字符数 |
[编辑] 返回值
如果成功，则返回写入目标数组的宽字符数，不包括终止的 L'\0'。
如果转换错误（如果遇到无效的多字节字符），则返回 static_cast<std::size_t> (-1)。
[编辑] 示例
运行此代码
#include <clocale> #include <cstdlib> #include <iostream> int main() { std::setlocale(LC_ALL, "en_US.utf8"); std::wcout.imbue(std::locale("en_US.utf8")); const char* mbstr = "z\u00df\u6c34\U0001f34c"; // or u8"zß水🍌" // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9f\x8d\x8c"; wchar_t wstr[5]; std::mbstowcs(wstr, mbstr, 5); std::wcout << "wide string: " << wstr << '\n'; }
输出
wide string: zß水🍌
[编辑] 另请参见
| 将窄多字节字符字符串转换为宽字符串，指定状态 (函数) | |
| 将宽字符串转换为窄多字节字符字符串 (函数) | |
| [虚拟] |
将字符串从 ExternT 转换为 InternT，例如从文件读取时( std::codecvt<InternT,ExternT,StateT> 的虚拟受保护成员函数) |
| C 文档 for mbstowcs
| |
