mbstowcs_s
在头文件<stdlib.h>中定义 | | |
|---|---|---|
| (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
*该函数将其结果作为出参数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，类似的行为是标准的。
参数
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）：
- 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函数
扩展内容
mbsrtowcsmbsrtowcs_s（C95）（C11） | 将一个窄多字节字符串转换为宽字符串，给定状态（函数） |
|---|---|
wcstombswcstombs_s（C11） | 将宽字符串转换为窄多字节字符串（函数） |
| mbstowcs的C ++文档 |
本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com
