1）将由* ps描述的转换状态开始的以空字符结尾的多字节字符序列从第一个元素由* src指向的数组转换为宽字符表示形式。 如果dst不为空，则转换的字符将存储在由dst指向的wchar_t数组的连续元素中。 不超过len宽字符被写入目标数组。 每个多字节字符转换就像通过调用mbrtowc。 在下列情况下停止转换：

*多字节空字符已转换并存储。 * src设置为NULL，* ps代表初始转换状态。

*遇到了一个无效的多字节字符（根据当前的C语言环境）。 * src被设置为指向第一个未转换的多字节字符的开头。

*要存储的下一个宽字符将超过len。 * src被设置为指向第一个未转换的多字节字符的开头。 如果dst == NULL，则不检查此条件。

2）与（1）相同，除以下情况：

*该函数将其结果作为out参数返回 retval

*如果写完len宽字符后没有空字符写入dst，则L'\ 0'存储在dst [len]中，这意味着写入len + 1总宽字符

*该函数从终止空值到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才能保证可用。

参数

返回值

1）成功时，返回写入字符数组中的宽字符数，不包括终止的L'\ 0'。 如果dst == NULL，则返回给定无限长度的宽字符数。 在转换错误（如果遇到无效多字节字符）时，返回（size_t）-1，将EILSEQ存储在errno中，并使* ps处于未指定状态。

2）成功时为零（在这种情况下，不包括终止零的宽字符的数量已经或将被写入dst，存储在* retval中），非错误发生。 在违反运行时约束的情况下，* retval中的stores（size_t）-1（除非retval为null）并将dst [0]设置为L'\ 0'（除非dst为null或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);
    int 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': %d\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

参考

• C11标准（ISO / IEC 9899：2011）：

• 7.29.6.4.1 mbsrtowcs函数（p：445）

• K.3.9.3.2.1 mbsrtowcs_s函数（p：648-649）

• C99标准（ISO / IEC 9899：1999）：

• 7.24.6.4.1 mbsrtowcs函数（p：391）

扩展内容

| mbsrtowcs的C ++文档 |