©
本文档使用
php.cn手册 发布
在头文件<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
*该函数将其结果作为out参数返回 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为空）
src数组中的第一个dstsz多字节字符中没有空字符，并且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）
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）：
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 ++文档 |
本文档系腾讯云云+社区成员共同维护，如有问题请联系 yunjia_community@tencent.com
在头文件<wctype.h>中定义 | ||
|---|---|---|
int iswdigit（wint_t ch）; | （自C95以来） |
检查给定的宽字符是否对应（如果缩小）十个十进制数字字符0123456789中的一个。
参数
CH | - | 宽字符 |
|---|
返回值
如果宽字符是数字字符，则为非零值，否则为零。
注意
iswdigit与iswxdigit是唯一不受当前安装的C语言环境影响的标准宽字符分类函数。
例
一些语言环境提供了检测非ASCII数字的附加字符类。
#include <stdio.h>#include <wctype.h>#include <wchar.h>#include <locale.h> void test(wchar_t a3, wchar_t u3, wchar_t j3){ printf(" '%lc' '%lc' '%lc'\n", a3, u3, j3); printf("iswdigit %d %d %d\n", !!iswdigit(a3), !!iswdigit(u3), !!iswdigit(j3)); printf("jdigit: %d %d %d\n", !!iswctype(a3, wctype("jdigit")), !!iswctype(u3, wctype("jdigit")), !!iswctype(j3, wctype("jdigit")));}
int main(void){
wchar_t a3 = L'3'; // the ASCII digit 3
wchar_t u3 = L'三'; // the CJK numeral 3
wchar_t j3 = L'３'; // the fullwidth digit 3
setlocale(LC_ALL, "en_US.utf8"); puts("In American locale:"); test(a3, u3, j3);
setlocale(LC_ALL, "ja_JP.utf8"); puts("\nIn Japanese locale:"); test(a3, u3, j3);}输出：
In American locale: '3' '三' '３'iswdigit 1 0 0jdigit: 0 0 0 In Japanese locale: '3' '三' '３'iswdigit 1 0 0jdigit: 0 0 1
参考
C11标准（ISO / IEC 9899：2011）：
7.30.2.1.5 iswdigit函数（p：449）
C99标准（ISO / IEC 9899：1999）：
7.25.2.1.5 iswdigit函数（p：395）
扩展内容
isdigit | 检查一个字符是否是一个数字（功能） |
|---|
| 用于iswdigit的C ++文档 |
ASCII 值 (十六进制) | 字符 | iscntrl iswcntrl. | isprint iswprint. | isspace iswspace. | isblank iswblank. | isgraph iswgraph. | ispunct iswpunct. | isalnum iswalnum. | isalpha iswalpha. | isupper iswupper. | islower iswlower. | isdigit iswdigit. | isxdigit iswxdigit. | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 - 8 | 0x00-0x08 | 控制码 (NUL, etc.) | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
9 | 0x09 | tab (\t) | ≠0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
10 - 13 | 0x0A-0x0D | 空格 (\n,\v,\f,\r) | ≠0 | 0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
14 - 31 | 0x0E-0x1F | 控制码 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
32 | 0x20 | space | 0 | ≠0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
33 - 47 | 0x21-0x2F | !"#$%&'()*+,-./ | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
48 - 57 | 0x30-0x39 | 0123456789 | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | 0 | 0 | 0 | ≠0 | ≠0 |
58 - 64 | 0x3a-0x40 | :;<=>?@ | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
65 - 70 | 0x41-0x46 | ABCDEF | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | ≠0 | 0 | 0 | ≠0 |
71 - 90 | 0x47-0x5A | GHIJKLMNOPQRSTUVWXYZ | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | ≠0 | 0 | 0 | 0 |
91 - 96 | 0x5B-0x60 | []^_` | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | | ||||||||||||
97 -102 | 0x61-0x66 | abcdef | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | 0 | ≠0 | 0 | ≠0 |
103-122 | 0x67-0x7A | ghijklmnopqrstuvwxyz | 0 | ≠0 | 0 | 0 | ≠0 | 0 | ≠0 | ≠0 | 0 | ≠0 | 0 | 0 |
123-126 | 0x7B-0x7E | {|}~ | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
127 | 0x7F | 退格 (DEL) | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |