mbsrtowcs

mbsrtowcs, mbsrtowcs_s

在头文件中定义
	(1)
size_t mbsrtowcs（wchar_t * dst，const char * src，size_t len，mbstate_t * ps）;	（自C95以来）
size_t mbsrtowcs（wchar_t * restrict dst，const char ** restrict src，size_t len，mbstate_t * restrict ps）;	（自C99以来）
errno_t mbsrtowcs_s（size_t * restrict retval，wchar_t * restrict dst，rsize_t dstsz，const char ** restrict src，rsize_t len，mbstate_t * restrict ps）;	(2)	（自C11以来）

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是空指针

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

参数

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

返回值

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

扩展内容

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

| mbsrtowcs的C ++文档 |