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 指向的数组中可用字节数 |
[编辑] 返回值
成功时，返回写入字符数组（其首元素由 dst 指向）的字节数（包括任何移位序列，但不包括终止符 '\0'）。
转换错误时（如果遇到无效宽字符），返回 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
| |
