当前位置： C语言 -- 附录 -- strcat_s

strcat_s函数

概要： 
#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h>
errno_t strcat_s(char * restrict s1,
      rsize_t s1max,
      const char * restrict s2);
描述：

该函数将参数s2指向字符串(包括终止空字符。)的副本添加到参数s1指向字符串的末尾。参数s2指向字符串的初始字符覆盖参数s1指向字符串的终止空字符。

strcat_s函数返回时，参数s1指向的数组中strcat_s函数写入的终止空字符（如果有）之后的所有元素值都是未指定的。

运行约束：

假设： m表示表达式s1max - strnlen_s(s1, s1max)的值。

参数s1和参数s2不能是空指针。参数s1max应不大于宏RSIZE_MAX，且不等于0。m不等于0且m应大于strnlen_s(s2, m)。复制不应发生在重叠对象之间。

在存在运行约束冲突的情况下，如果参数s1不是空指针，参数s1max大于0且不大于宏RSIZE_MAX，函数将s1[0]设置为空字符。

参数：
char * restrict s1

指向目标数组的指针，结果字符串将存入该数组。

rsize_t s1max

目标数组中修改的最大字符数。

const char * restrict s2

指向连接字符串的指针。

返回值：

如果不存在运行约束冲突，函数返回0；否则函数返回非0值。

范例： 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
/*安全函数strcat_s范例*/

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <string.h>

#define LENGTH 100

int main(void)
{
    char strOne[LENGTH] = "Hello ";
    const char strTwo[] = "world";

    if(!strcat_s(strOne, LENGTH, strTwo))
        puts(strOne);
    
    return 0;
}
输出：

Hello world

注：使用Visual Studio编译。

相关内容：
strcat 连接字符串的函数。
strncat_s 向字符串添加限定数量字符的安全函数。