c语言字符串strcpy_s,strcpy_s - [ C语言中文开发手册 ] - 在线原生手册 - php中文网...

左手的ㄟ右手 2023-01-22 11:56 12阅读 0赞

在头文件中定义(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'３'; // 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 - 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