strcpy_s

1）将由src指向的空终止字节字符串（包括空终止符）复制到第一个元素由dest指向的字符数组中。

如果dest数组不够大，行为是不确定的。 如果字符串重叠，则行为未定义。 如果dest不是指向字符数组的指针，或者src不是指向以空字符结尾的字节字符串的指针，则行为是未定义的。

2）与（1）相同，除了可以用未指定的值来摧毁目标数组的其余部分，并且在运行时检测到以下错误并调用当前安装的约束处理函数：

• src或者dest是空指针
• destsz 是零或大于 RSIZE_MAX
• destsz小于或等于strnlen_s(src, destsz); 换句话说，会发生截断
• 源和目标字符串之间会发生重叠

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

参数

返回值

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 <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）：
  • 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函数

扩展内容

| 用于strcpy的C ++文档 |