mbstowcs

mbstowcs, mbstowcs_s

在头文件中定义
	(1)
size_t mbstowcs（wchar_t * dst，const char * src，size_t len）	（直到C99）
size_t mbstowcs（wchar_t * restrict dst，const char * restrict src，size_t len）	（自C99以来）
errno_t mbstowcs_s（size_t * restrict retval，wchar_t * restrict dst，rsize_t dstsz，const char * restrict src，rsize_t len）;	(2)	（自C11以来）

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

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

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

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

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

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

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

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

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

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

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

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

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

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

retval或src是一个空指针

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

注意

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

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

参数

dst	-	宽字符串将被存储的宽字符数组指针
src	-	指向要转换的以空字符结尾的多字节字符串的第一个元素的指针
len	-	由dst指向的数组中可用的宽字符数
dstsz	-	将写入的最大宽字符数（dst数组的大小）
retval	-	指向将存储结果的size_t对象的指针

返回值

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）

Example

#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）：

扩展内容

mbsrtowcsmbsrtowcs_s（C95）（C11）	将一个窄多字节字符串转换为宽字符串，给定状态（函数）
wcstombswcstombs_s（C11）	将宽字符串转换为窄多字节字符串（函数）

| mbstowcs的C ++文档 |