mbsrtowcs, mbsrtowcs_s
来自 cppreference.com
| 在头文件 <wchar.h> 中定义 |
||
| (1) | ||
| (自 C95 起) (直到 C99) |
||
| (自 C99 起) | ||
| (2) | (自 C11 起) | |
1) 将以 null 结尾的多字节字符序列（以
*ps 描述的转换状态开始）从其第一个元素指向的数组（由 *src 指向）转换为其宽字符表示形式。如果 dst 不为空，则转换后的字符将存储在 dst 指向的 wchar_t 数组的连续元素中。写入目标数组的宽字符不超过 len 个。每个多字节字符都将按照 mbrtowc 的调用方式进行转换。转换将在以下情况下停止：- 多字节空字符已转换并存储。 *src 设置为空指针值，
*ps表示初始移位状态。 - 遇到无效的多字节字符（根据当前 C 本地化）。 *src 设置为指向第一个未转换的多字节字符的开头。
- 要存储的下一个宽字符将超过
len。 *src 设置为指向第一个未转换的多字节字符的开头。如果dst为空指针，则不会检查此条件。
2) 与 (1) 相同，但
- 该函数以输出参数
retval返回其结果 - 如果在写入
len个宽字符后没有将空字符写入dst，则 L'\0' 将存储在dst[len]中，这意味着总共写入 len+1 个宽字符 - 该函数从终止 null 开始，一直到
dstsz，会破坏目标数组 - 如果
src和dst重叠，则行为未定义。 - 以下错误将在运行时检测到，并调用当前安装的 约束处理程序 函数
-
retval、ps、src或 *src 是空指针 -
dstsz或len大于 RSIZE_MAX/sizeof(wchar_t)（除非dst为空） -
dstsz不为零（除非dst为空） - *src 数组中前
dstsz个多字节字符中没有空字符，并且len大于dstsz（除非dst为空）
-
- 与所有边界检查函数一样，只有在实现通过 __STDC_LIB_EXT1__ 定义，并且用户在包含 <wchar.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时，
mbsrtowcs_s才能保证可用。
内容 |
[编辑] 参数
| dst | - | 指向将存储结果的宽字符数组的指针 |
| src | - | 指向以 null 结尾的多字节字符串的第一个元素的指针 |
| len | - | dst 指向的数组中可用的宽字符数量 |
| ps | - | 指向转换状态对象的指针 |
| dstsz | - | 将要写入的最大宽字符数量（dst 数组的大小） |
| retval | - | 指向将存储结果的 size_t 对象的指针 |
[编辑] 返回值
1) 成功时，返回写入字符数组的宽字符数量（不包括终止的 L'\0'）。如果
dst 是空指针，则返回在给定无限长度的情况下将要写入的宽字符数量。如果转换错误（如果遇到无效的多字节字符），则返回 (size_t)-1，将 EILSEQ 存储在 errno 中，并将 *ps 留在未指定的状态。2) 成功时为零（在这种情况下，在
dst 中写入（或将要写入）的宽字符数量（不包括终止的零）将存储在 *retval 中），错误时为非零。如果发生运行时约束违规，则将 (size_t)-1 存储在 *retval 中（除非 retval 为空），并将 dst[0] 设置为 L'\0'（除非 dst 为空或 dstmax 为零或大于 RSIZE_MAX）[编辑] 示例
运行此代码
#include <stdio.h> #include <locale.h> #include <wchar.h> #include <string.h> void print_as_wide(const char* mbstr) { mbstate_t state; memset(&state, 0, sizeof state); size_t len = 1 + mbsrtowcs(NULL, &mbstr, 0, &state); wchar_t wstr[len]; mbsrtowcs(&wstr[0], &mbstr, len, &state); wprintf(L"Wide string: %ls \n", wstr); wprintf(L"The length, including L'\\0': %zu\n", len); } int main(void) { setlocale(LC_ALL, "en_US.utf8"); print_as_wide(u8"z\u00df\u6c34\U0001f34c"); // u8"zß水🍌" }
输出
Wide string: zß水🍌 The length, including L'\0': 5
