std::wcstombs
来自 cppreference.cn
| 定义于头文件 <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 的数组中可用的字节数 |
[编辑] 返回值
成功时，返回写入字符数组的字节数（包括任何移位序列，但不包括终止符 '\0'），该字符数组的首元素由 dst 指向。
在转换错误时（如果遇到无效的宽字符），返回 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 文档 关于 wcstombs
| |
