strncat, strncat_s

定义于头文件 `<string.h>`
	(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) 将最多 count 个字符从 src 指向的字符数组追加到 dest 指向的以空字符结尾的字节字符串的末尾，如果在 src 中遇到空字符则停止。字符 src[0] 替换 dest 末尾的空终止符。终止空字符始终附加在末尾（因此函数最多可以写入 count+1 个字节）。

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

2) 与 (1) 相同，但此函数可能会破坏目标数组的其余部分（从写入的最后一个字节到 destsz），并且在运行时检测到以下错误并调用当前安装的约束处理程序函数

`src` 或 `dest` 是空指针
destsz 或 count 为零或大于 RSIZE_MAX
dest 的前 destsz 字节中没有空字符
会发生截断：count 或 src 的长度（取较小者）超过了 dest 的空终止符和 destsz 之间可用的空间。
源字符串和目标字符串之间会发生重叠

如果 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 可用。

尽管截断以适应目标缓冲区是安全风险，因此对于 strncat_s 来说是运行时约束违规，但可以通过将 count 指定为目标数组大小减一来实现截断行为：它将复制前 count 个字节并像往常一样追加空终止符：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); // r4 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

[编辑] 参考

C23 标准 (ISO/IEC 9899:2024)

7.26.3.2 strncat 函数 (p: 379)

K.3.7.2.2 strncat_s 函数 (p: 待定)

C17 标准 (ISO/IEC 9899:2018)

7.24.3.2 strncat 函数 (p: 265-266)

K.3.7.2.2 strncat_s 函数 (p: 449-450)

C11 标准 (ISO/IEC 9899:2011)

7.24.3.2 strncat 函数 (p: 364-365)

K.3.7.2.2 strncat_s 函数 (p: 618-620)

C99 标准 (ISO/IEC 9899:1999)

7.21.3.2 strncat 函数 (p: 327-328)

C89/C90 标准 (ISO/IEC 9899:1990)

4.11.3.2 strncat 函数

[编辑] 另请参阅

strcatstrcat_s (C11)	连接两个字符串 (函数) [编辑]
strcpystrcpy_s (C11)	将一个字符串复制到另一个字符串 (函数) [编辑]
memccpy (C23)	将一个缓冲区复制到另一个缓冲区，在指定的分隔符处停止 (函数) [编辑]
C++ 文档关于 strncat

编译器支持
语言
头文件
类型支持
程序工具
变参函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作

strncat, strncat_s

目录

[编辑] 参数

[编辑] 返回值

[编辑] 注意

[编辑] 示例

[编辑] 参考

[编辑] 另请参阅

导航

工具箱

dest	-	指向要追加的以空字符结尾的字节字符串的指针
src	-	指向要复制的字符数组的指针
count	-	要复制的最大字符数
destsz	-	目标缓冲区的尺寸