strcat_s

strcat, strcat_s

在头文件中定义
	(1)
char * strcat（char * dest，const char * src）;	（直到C99）
char * strcat（char * restrict dest，const char * restrict src）;	（自C99以来）
errno_t strcat_s（char * restrict dest，rsize_t destsz，const char * restrict src）;	(2)	（自C11以来）

1）将由src指向的空终止字节串的副本追加到由dest指向的以空字节终止的字节串的末尾。字符src [0]替换dest结尾处的空终止符。得到的字节字符串以空字符结尾。

如果目标数组的大小不足以满足src和dest的内容以及终止空字符，则行为未定义。如果字符串重叠，则行为未定义。如果dest或src不是指向以空字符结尾的字节字符串的指针，则行为未定义。

2）与（1）相同，只不过它可能会将未指定值的目标数组的剩余部分（从写入到destsz的最后一个字符中）截断，并且在运行时检测到以下错误并调用当前安装的约束处理函数：

src或者dest是空指针

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

参数

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

返回值

1）返回 dest 副本

2）在成功时返回零，错误时返回非零值。另外，如果发生错误，则将零写入dest [0]（除非dest是空指针或destsz为零或大于RMAX_SIZE）。

注意

为了提高效率，strcat_s允许从最后写入destsz的字符中截断目标数组：它可以复制多字节块，然后检查空字节。

函数strcat_s与BSD函数strlcat相似，除以下情况：

strlcat 截断源字符串以适合目标

虽然strcat_s由于潜在的安全风险而禁止截断，但可以使用bounds-checked strncat_s来截断字符串。

例

#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h> 
#include <stdio.h>
#include <stdlib.h>
 
int main(void) 
{
    char str[50] = "Hello ";
    char str2[50] = "World!";
    strcat(str, str2
    strcat(str, " ..."
    strcat(str, " Goodbye World!"
    puts(str
 
#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s
    int r = strcat_s(str, sizeof str, " ... "
    printf("str = \"%s\", r = %d\n", str, r
    r = strcat_s(str, sizeof str, " and this is too much"
    printf("str = \"%s\", r = %d\n", str, r
#endif
}

可能的输出：

Hello World! ... Goodbye World!
str = "Hello World! ... Goodbye World! ... ", r = 0
str = "", r = 22

参考

C11标准（ISO / IEC 9899：2011）：

扩展内容

strncatstrncat_s（C11）	串联一定数量的两个字符串（函数）
strcpystrcpy_s（C11）	将一个字符串复制到另一个（函数）

| strcat的C ++文档 |