std::mbstowcs
来自 cppreference.cn
< cpp | string | multibyte (多字节)
| 定义于头文件 <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 文档 关于 mbstowcs
| |
