std::mbstowcs
来自 cppreference.cn
| 定义于头文件 <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
| |
