C

mbstowcs_s

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。

如果srcdst重叠,则行为是不确定的

2)与(1)相同,除以下情况:

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

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

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

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

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

*如果srcdst重叠,则行为是未指定的。

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

  • 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)

#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 ++文档 |