1）将多字节字符串从第一个元素被src指向的数组转换为宽字符表示形式。 转换后的字符存储在由dst指向的数组的连续元素中。 不超过len宽字符被写入目标数组。

除了mbtowc转换状态不受影响之外，每个字符都转换为像通过调用mbtowc一样。 在下列情况下停止转换：

*多字节空字符已转换并存储。

*遇到无效（在当前C语言环境中）多字节字符。

*要存储的下一个宽字符将超过len。

如果src和dst重叠，则行为是不确定的

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

*通过mbrtowc转换为 as-if ，而不是mbtowc

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

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

*如果dst是一个空指针，将产生的宽字符数存储在* retval中

*该函数从终止空值到dstsz之间破坏目标数组

*如果src和dst重叠，则行为是未指定的。

*在运行时检测到以下错误并调用当前安装的约束处理函数：

• retval或者src是空指针

• dstsz或len大于RSIZE_MAX/sizeof(wchar_t)（除非dst为空）

• dstsz不为零（除非dst为空）

• 数组中的第一个dstsz多字节字符中没有空字符，src并且len大于dstsz（除非dst为空）

作为所有边界检查函数，只有当__STDC_LIB_EXT1__由实现定义并且在包含stdlib.h之前用户将__STDC_WANT_LIB_EXT1__定义为整数常量1时，mbstowcs_s才能保证可用。

注意

在大多数实现中，mbstowcs在处理整个字符串时更新一个类型为mbstate_t的全局静态对象，并且不能由两个线程同时调用，在这种情况下应该使用mbsrtowcs。

POSIX指定一个公共扩展名：如果dst是空指针，则该函数返回将被写入dst的宽字符数（如果转换）。 对于mbstowcs_s和mbsrtowcs，类似的行为是标准的。

参数

返回值

1）成功时，返回写入目标数组的宽字符数（不包括终止的L'\ 0）。 在转换错误（如果遇到无效多字节字符）时，返回（size_t）-1。

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 <stdlib.h>#include <wchar.h>
 int main(void){    setlocale(LC_ALL, "en_US.utf8");    const char* mbstr = u8"z\u00df\u6c34\U0001F34C"; // or u8"zß水?"
    wchar_t wstr[5];    mbstowcs(wstr, mbstr, 5);    wprintf(L"MB string: %s\n", mbstr);    wprintf(L"Wide string: %ls\n", wstr);}

输出：

MB string: zß水?Wide string: zß水?

参考

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

• 7.22.8.1 mbstowcs函数（p：359）

• K.3.6.5.1 mbstowcs_s函数（p：611-612）

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

• 7.20.8.1 mbstowcs函数（p：323）

• C89 / C90标准（ISO / IEC 9899：1990）：

• 4.10.8.1 mbstowcs函数

扩展内容

| mbstowcs的C ++文档 |