strcat, strcat_s
来自cppreference.com
| 在标头 <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
参阅
| (C11) |
连接两个字符串的一定数量字符 (函数) |
| (C11) |
复制一个字符串给另一个 (函数) |
| (C23) |
复制一个缓冲区到另一个，在指定的分隔符后停止 (函数) |