在头文件中定义(1)
char * strcpy(char * dest,const char * src);(直到C99)
char * strcpy(char * restrict dest,const char * restrict src);(自C99以来)
errno_t strcpy_s(char * restrict dest,rsize_t destsz,const char * restrict src);(2)(自C11以来)
1)将由src指向的空终止字节字符串(包括空终止符)复制到第一个元素由dest指向的字符数组中。
如果dest数组不够大,行为是不确定的。 如果字符串重叠,则行为未定义。 如果dest不是指向字符数组的指针,或者src不是指向以空字符结尾的字节字符串的指针,则行为是未定义的。
2)与(1)相同,除了可以用未指定的值来摧毁目标数组的其余部分,并且在运行时检测到以下错误并调用当前安装的约束处理函数:
src或者dest是空指针
destsz 是零或大于 RSIZE_MAX
destsz小于或等于strnlen_s(src, destsz); 换句话说,会发生截断
源和目标字符串之间会发生重叠
如果由dest <= strnlen_s(src,destsz)
参数
dest-指向要写入的字符数组的指针src-指向要从中复制的以null结尾的字节字符串
destsz-最大写入字符数,通常是目标缓冲区的大小
返回值
1)返回dest 副本
2)在成功时返回零,错误时返回非零值。 此外,如果出错,则将零写入dest [0](除非dest为空指针或destsz为零或大于RSIZE_MAX)。
注意
允许strcpy_s从最后一个写入destsz的字符中截断目标数组,以提高效率:它可以复制多字节块,然后检查空字节。
函数strcpy_s与BSD函数strlcpy相似,除以下情况:
strlcpy 截断源字符串以适应目标(这是一种安全风险)
strlcpy不执行所有的运行时检查是strcpy_s不会
strlcpy 通过将目标设置为空字符串或在调用失败时调用处理程序不会使失败变得明显。
尽管strcpy_s由于潜在的安全风险而禁止截断,但可以使用bounds-checked strncpy_s来截断字符串。
例
#define __STDC_WANT_LIB_EXT1__ 1#include #include #include
int main(void){
char *src = "Take the test.";// src[0] = 'M' ; // this would be undefined behavior
char dst[strlen(src) + 1]; // +1 to accomodate for the null terminator strcpy(dst, src);
dst[0] = 'M'; // OK printf("src = %s\ndst = %s\n", src, dst);
#ifdef __STDC_LIB_EXT1__ set_constraint_handler_s(ignore_handler_s);
int r = strcpy_s(dst, sizeof dst, src); printf("dst = \"%s\", r = %d\n", dst, r);
r = strcpy_s(dst, sizeof dst, "Take even more tests."); printf("dst = \"%s\", r = %d\n", dst, r);#endif}
可能的输出:
src = Take the test.dst = Make the test.dst = "Take the test.", r = 0dst = "", r = 22
参考
C11标准(ISO / IEC 9899:2011):7.24.2.3 strcpy函数(p:363)
K.3.7.1.3 strcpy_s函数(p:615-616)
C99标准(ISO / IEC 9899:1999):7.21.2.3 strcpy函数(p:326)
C89 / C90标准(ISO / IEC 9899:1990):4.11.2.3 strcpy函数
扩展内容
strncpystrncpy_s(C11)将一定数量的字符从一个字符串复制到另一个字符串(函数)memcpymemcpy_s(C11)将一个缓冲区复制到另一个(功能)
wcscpywcscpy_s(C95)(C11)将一个宽字符串复制到另一个(函数)
strdup(动态内存TR)分配一个字符串(函数)的副本
| 用于strcpy的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 - 80x00-0x08控制码 (NUL, etc.)≠000000000000
90x09tab (\t)≠00≠0≠000000000
10 - 130x0A-0x0D空格 (\n,\v,\f,\r)≠00≠0000000000
14 - 310x0E-0x1F控制码≠000000000000
320x20space0≠0≠0≠000000000
33 - 470x21-0x2F!"#$%&'()*+,-./0≠000≠0≠0000000
48 - 570x30-0x3901234567890≠000≠00≠0000≠0≠0
58 - 640x3a-0x40:;<=>?@0≠000≠0≠0000000
65 - 700x41-0x46ABCDEF0≠000≠00≠0≠0≠000≠0
71 - 900x47-0x5AGHIJKLMNOPQRSTUVWXYZ0≠000≠00≠0≠0≠0000
91 - 960x5B-0x60[]^_` | 0 | ≠0 | 0 | 0 | ≠0 | ≠0 | 0 | 0 | 0 | 0 | 0 | 0 |
97 -1020x61-0x66abcdef0≠000≠00≠0≠00≠00≠0
103-1220x67-0x7Aghijklmnopqrstuvwxyz0≠000≠00≠0≠00≠000
123-1260x7B-0x7E{|}~0≠000≠0≠0000000
1270x7F退格 (DEL)≠000000000000