# C 语言标准库函数 strncat

/*********************************************
 * @brief 拼接字符串
 * @param dest 目标字符串
 * @param src 源字符串
 * @param count 最多复制的字节数
 * @return 字符串的长度
 ********************************************/
char* strncat(char* restrict dest, const char* restrict src, size_t count);

!subtitle:说明

将 src 指向的字符串拼接到 dest 指向的字符串之后，最多复制 count 字节。

如果 src 指向的字符串长度大于等于 count 字节，拼接到的 dest 时将自动将末尾设为 0。

注意：

• dest 必须有足够的空间

• dest 和 src 指向的字符串不可以存在重叠

!subtitle:参数

• dest - 目标字符串

• src - 源字符串

• count - 最多复制的字节数，包括结尾的 0

!subtitle:返回值

• 字符串的长度（不含结尾的 0）

# 示例

#include <stdio.h>
#include <string.h>

#define N 16

int main(void)
{
    char dest[N] = "hello";

    strncat(dest, "world", N - strlen(dest));  // 最多复制 32 - strlen(dest) 个字符，避免越界
    printf("%s\n", dest);   
    
    strncat(dest, "ABCDEFGHIJKLMNOPQRSTUVWXYZ", N - strlen(dest));  // 最多复制 32 - strlen(dest) 个字符，避免越界
    printf("%s\n", dest);   

    return 0;
}

说明：

• count 设为 N - strlen(dest) 避免越界

• 将 "world" 拼接到 dest 时，长度未超出，正常完整拼接

• 将 "ABCDEFGHIJKLMNOPQRSTUVWXYZ" 拼接到 dest 超出长度 N - strlen(dest) 被截断，末尾自动设为 0

运行结果：

helloworld
helloworldABCDEF

# 推荐阅读

• C 语言标准库函数 strcat

• strncat - cppreference

# 参考标准

• C23 standard (ISO/IEC 9899:2024):

  • 7.26.3.2 The strncat function (p: 379)

• C17 standard (ISO/IEC 9899:2018):

  • 7.24.3.2 The strncat function (p: 265-266)

• C11 standard (ISO/IEC 9899:2011):

  • 7.24.3.2 The strncat function (p: 364-365)

• C99 standard (ISO/IEC 9899:1999):

  • 7.21.3.2 The strncat function (p: 327-328)

• C89/C90 standard (ISO/IEC 9899:1990):

  • 4.11.3.2 The strncat function