©
This document usesPHP Chinese website manualRelease
在头文件 |
|
|
---|---|---|
|
(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)
#include#include #include #include 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
在头文件 |
|
|
---|---|---|
int iswdigit(wint_t ch); |
|
(自C95以来) |
检查给定的宽字符是否对应(如果缩小)十个十进制数字字符0123456789中的一个。
CH |
- |
宽字符 |
---|
如果宽字符是数字字符,则为非零值,否则为零。
iswdigit
与iswxdigit
是唯一不受当前安装的C语言环境影响的标准宽字符分类函数。
一些语言环境提供了检测非ASCII数字的附加字符类。
#include#include #include #include 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'3'; // 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' '三' '3'iswdigit 1 0 0jdigit: 0 0 0 In Japanese locale: '3' '三' '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 |