strncat_s

strncat, strncat_s

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

1）追加由src指向的字符数组中的大多数计数字符，如果找到空字符，则停止到由dest指向的以null结尾的字节字符串的末尾。字符src [0]替换dest结尾处的空终止符。终止空字符总是附加在最后（因此函数可以写入的最大字节数为count + 1）。

如果目标数组没有足够的空间用于dest和src的第一个计数字符的内容以及终止的空字符，则行为未定义。如果源和目标对象重叠，则行为未定义。如果dest不是指向以空字符结尾的字节字符串的指针，或者src不是指向字符数组的指针，则行为未定义.

2）与（1）相同，只是此函数可能会打断目标数组的其余部分（从写入到destsz的最后一个字节开始），并且在运行时检测到以下错误并调用当前安装的约束处理函数：

src或者dest是空指针

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

参数

dest	-	指向要附加到的以空字符结尾的字节字符串
SRC	-	指向要复制的字符数组的指针
count	-	最大数量的字符复制
destsz	-	目标缓冲区的大小

返回值

1）返回 dest 副本

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

注意

尽管适合目标缓冲区的截断存在安全风险，并且因此违反了strncat_s的运行时间约束，但可以通过指定count等于目标数组的大小减1来获得截断行为：它将复制第一个计数字节和像往常一样添加空终止符：strncat_s（dst，sizeof dst，src，（sizeof dst）-strnlen_s（dst，sizeof dst）-1）;

例

#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
    strncat(str, " Goodbye World!", 3
    puts(str
 
#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s
    char s1[100] = "good";
    char s5[1000] = "bye";
    int r1 = strncat_s(s1, 100, s5, 1000 // r1 is 0, s1 holds "goodbye\0"
    printf("s1 = %s, r1 = %d\n", s1, r1
    char s2[6] = "hello";
    int r2 = strncat_s(s2, 6, "", 1 // r2 is 0, s2 holds "hello\0"
    printf("s2 = %s, r2 = %d\n", s2, r2
    char s3[6] = "hello";
    int r3 = strncat_s(s3, 6, "X", 2 // r3 is non-zero, s3 holds "\0"
    printf("s3 = %s, r3 = %d\n", s3, r3
    // the strncat_s truncation idiom:
    char s4[7] = "abc";
    int r4 = strncat_s(s4, 7, "defghijklmn", 3 // r is 0, s4 holds "abcdef\0"
    printf("s4 = %s, r4 = %d\n", s4, r4
#endif
}

可能的输出：

Hello World! Go
s1 = goodbye, r1 = 0
s2 = hello, r2 = 0
s3 = , r3 = 22
s4 = abcdef, r4 = 0

参考

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

扩展内容

strcatstrcat_s（C11）	连接两个字符串（函数）
strcpystrcpy_s（C11）	将一个字符串复制到另一个（函数）

| strncat 的C ++文档|