strcat, strcat_s

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

字节字符串

多字节字符串

宽字符串

 

空终止字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换成数值格式
atof atoiatolatoll (C99) strtolstrtoll (C99)	strtoulstrtoull (C99) strtofstrtodstrtold (C99)(C99) strtoimaxstrtoumax (C99)(C99)
字符串操作
strcpystrcpy_s (C11)
strncpystrncpy_s (C11)
strcatstrcat_s (C11)
strncatstrncat_s (C11)
strxfrm
strdup (C23)
strndup (C23)
字符串检验
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr
memcmp
memsetmemset_s (C11)
memcpymemcpy_s (C11)
memmovememmove_s (C11)
memccpy (C23)
杂项
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

在标头 <string.h> 定义
	(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 为空指针
• destsz 为零或大于 RSIZE_MAX
• dest 的首 destsz 个字节中无空终止符
• 会出现截断（ dest 末尾的可用空间不能适应 src 的每个字符，包括空终止符）
• 源与目标字符串间会出现重叠

若 dest 所指向的字符数组大小 < strlen(dest)+strlen(src)+1 <= destsz 则行为未定义；换言之， destsz 的错误值不暴露行将发生的缓冲区溢出。

同所有边界检查函数， strcat_s 仅若实现定义了 __STDC_LIB_EXT1__ ，且用户在包含 string.h 前定义 __STDC_WANT_LIB_EXT1__ 为整数常量 1 才保证可用。

参数

dest	-	指向要后附到的空终止字节字符串的指针
src	-	指向作为复制来源的空终止字节字符串的指针
destsz	-	要写入的最大字符数，典型地为目标缓冲区的大小

返回值

1) 返回 dest 的副本。

2) 成功时返回零。错误时返回非零。错误时，亦写入零到 dest[0] （除非 dest 为空指针，或 destsz 为零或大于 RSIZE_MAX ）。

注解

因为 strcat 需要在每次调用时找到 dest 的结尾，故用 strcat 将多个字符串连接成一体是低效的。

为提升效率，允许 strcat_s 从最后被写入字符到 destsz 破坏目标数组：它可以用多字节块复制，然后检查空字节。

函数 strcat_s 类似 BSD 函数 strlcat ，除了

• strlcat 截断源字符串以适合目标
• strlcat 不进行所有 strcat_s 进行的运行时检查
• 若调用失败，则 strlcat 不设置目标为空字符串或调用处理函数，而令失败显著。

尽管 strcat_s 由于潜在安全风险禁止截断，还可以用带边界检查的 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）：

• 7.24.3.1 The strcat function （第 364 页）

• K.3.7.2.1 The strcat_s function （第 617-618 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.21.3.1 The strcat function （第 327 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.11.3.1 The strcat function

参阅

strncatstrncat_s (C11)	连接两个字符串的一定数量字符 (函数)
strcpystrcpy_s (C11)	复制一个字符串给另一个 (函数)