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 ++文档 |