C

strcpy_s

strcpy, strcpy_s

在头文件中定义
(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是空指针

如果由dest <= strnlen_s(src,destsz)<destsz;指向的字符数组的大小,行为是未定义的。 换句话说,destsz的错误值不会暴露即将发生的缓冲区溢出。 作为所有边界检查函数,只有当__STDC_LIB_EXT1__由实现定义并且在包含string.h之前用户将__STDC_WANT_LIB_EXT1__定义为整数常量1时,strcpy_s才能保证可用。

参数

dest-指向要写入的字符数组的指针
src-指向要从中复制的以null结尾的字节字符串
destsz-最大写入字符数,通常是目标缓冲区的大小

返回值

1)返回dest 副本

2)在成功时返回零,错误时返回非零值。 此外,如果出错,则将零写入dest [0](除非dest为空指针或destsz为零或大于RSIZE_MAX)。

注意

允许strcpy_s从最后一个写入destsz的字符中截断目标数组,以提高效率:它可以复制多字节块,然后检查空字节。

函数strcpy_s与BSD函数strlcpy相似,除以下情况:

  • strlcpy 截断源字符串以适应目标(这是一种安全风险)

尽管strcpy_s由于潜在的安全风险而禁止截断,但可以使用bounds-checked strncpy_s来截断字符串。

#define __STDC_WANT_LIB_EXT1__ 1 #include <string.h> #include <stdio.h> #include <stdlib.h> 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 = 0 dst = "", r = 22

参考

  • C11标准(ISO / IEC 9899:2011):

扩展内容

strncpystrncpy_s(C11)将一定数量的字符从一个字符串复制到另一个字符串(函数)
memcpymemcpy_s(C11)将一个缓冲区复制到另一个(功能)
wcscpywcscpy_s(C95)(C11)将一个宽字符串复制到另一个(函数)
strdup(动态内存TR)分配一个字符串(函数)的副本

| 用于strcpy的C ++文档 |