非常教程

C参考手册

字符串 | Strings

strcat

在头文件<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
  • 在第一个destsz字节中没有空终止符dest
  • 将会发生截断(在末尾的可用空间dest不适合每个字符,包括空终止符src
  • 源和目标字符串之间会发生重叠

如果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 截断源字符串以适合目标
  • strlcat不执行所有的运行时检查是strcat_s不会
  • 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):
    • 7.24.3.1 strcat函数(p:364)
    • K.3.7.2.1 strcat_s函数(p:617-618)
  • C99标准(ISO / IEC 9899:1999):
    • 7.21.3.1 strcat函数(p:327)
  • C89 / C90标准(ISO / IEC 9899:1990):
    • 4.11.3.1 strcat函数

扩展内容

strncatstrncat_s(C11)

串联一定数量的两个字符串(函数)

strcpystrcpy_s(C11)

将一个字符串复制到另一个(函数)

| strcat的C ++文档 |

C

C 语言是一门通用计算机编程语言,应用广泛。C 语言的设计目标是提供一种能以简易的方式编译、处理低级存储器、产生少量的机器码以及不需要任何运行环境支持便能运行的编程语言。