strncpy (Strings) – C 中文开发手册

??C 语言中文开发手册

strncpy (Strings) - C 中文开发手册

1）将由src指向的字符数组的大部分计数字符（包括终止空字符，但不包括空字符后面的任何字符）复制到由dest指向的字符数组。如果在复制完整个数组src之前达到count，则生成的字符数组不会以null结尾。如果在复制src中的终止空字符之后，未达到count，则将额外的空字符写入dest，直到写入总计数字符。如果字符数组重叠，如果dest或src不是指向字符数组的指针（包括如果dest或src是空指针），如果dest指向的数组大小小于count，则行为未定义， 或者如果src指向的数组大小小于count并且不包含空字符。2）与（1）相同，除了该函数不会继续将零写入目标数组以填充计数，它将在写入终止空字符后停止（如果源中没有空值，它将在dest处写入一个 [count]然后停止）。 此外，在运行时检测到以下错误并调用当前安装的约束处理函数：src或者dest是空指针destsz或者count是零或大于RSIZE_MAX count大于或等于destsz，但destsz小于或等于strnlen_s(src, count)，换句话说，会发生截断源和目标字符串之间会发生重叠如果dest <strnlen_s（src，destsz）<= destsz指向的字符数组的大小，则行为不确定; 换句话说，destsz的错误值不会暴露即将发生的缓冲区溢出。 如果字符数组的大小由src <strnlen_s（src，count）<destsz; 换句话说，count的错误值不会暴露即将发生的缓冲区溢出。作为所有边界检查函数，只有当__STDC_LIB_EXT1__由实现定义并且用户在包含string.h之前将__STDC_WANT_LIB_EXT1__定义为整数常量1时，strncpy_s才能保证可用。

参数

返回值

1）返回 dest 副本2）在成功时返回零，错误时返回非零值。 另外，如果出错，则将0写入dest [0]（除非dest为空指针或destsz为零或大于RSIZE_MAX），并可能用未指定的值来摧毁目标数组的其余部分。

注意

正如后C11 DR 468所纠正的那样，strncpy_s与strcpy_s不同，只有在发生错误时才允许对目标数组的其余部分进行截断。与strncpy不同，strncpy_s不会用零填充目标数组，这是将现有代码转换为边界检查版本时常见的错误来源。尽管适合目标缓冲区的截断存在安全风险，并因此违反了strncpy_s的运行时间约束，但可以通过指定count等于目标数组的大小减1来获得截断行为：它将复制第一个计数字节和 像往常一样追加空终止符：strncpy_s（dst，sizeof dst，src，（sizeof dst）-1）;

例

#define __STDC_WANT_LIB_EXT1__ 1
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    char src[] = "hi";
    char dest[6] = "abcdef"; // no null terminator
    strncpy(dest, src, 5); // writes five characters ‘h‘, ‘i‘, ‘\0‘, ‘\0‘, ‘\0‘ to dest
    printf("strncpy(dest, src, 5) to a 6-byte dest gives : ");
    for(size_t n = 0; n < sizeof dest; ++n) {
        char c = dest[n];
        c ? printf("‘%c‘ ", c) : printf("‘\\0‘ ");
    }
 
    printf("\nstrncpy(dest2, src, 2) to a 2-byte dst gives : ");
    char dest2[2];
    strncpy(dest2, src, 2); // truncation: writes two characters ‘h‘, ‘i‘, to dest2
    for(size_t n = 0; n < sizeof dest2; ++n) {
        char c = dest2[n];
        c ? printf("‘%c‘ ", c) : printf("‘\\0‘ ");
    }
    printf("\n");
 
#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s);
    char dst1[6], src1[100] = "hello";
    int r1 = strncpy_s(dst1, 6, src1, 100);      // writes 0 to r1, 6 characters to dst1
    printf("dst1 = \"%s\", r1 = %d\n", dst1,r1); // ‘h‘,‘e‘,‘l‘,‘l‘,‘o‘,‘\0‘ to dst1
 
    char dst2[5], src2[7] = {‘g‘,‘o‘,‘o‘,‘d‘,‘b‘,‘y‘,‘e‘};
    int r2 = strncpy_s(dst2, 5, src2, 7);        // copy overflows the destination array
    printf("dst2 = \"%s\", r2 = %d\n", dst2,r2); // writes nonzero to r2,‘\0‘ to dst2[0]
 
    char dst3[5];
    int r3 = strncpy_s(dst3, 5, src2, 4);        // writes 0 to r3, 5 characters to dst3
    printf("dst3 = \"%s\", r3 = %d\n", dst3,r3); // ‘g‘, ‘o‘, ‘o‘, ‘d‘, ‘\0‘ to dst3 
#endif
}

可能的输出：

strncpy(dest, src, 5) to a 6-byte dst gives : ‘h‘ ‘i‘ ‘\0‘ ‘\0‘ ‘\0‘ ‘f‘
strncpy(dest2, src, 2) to a 2-byte dst gives : ‘h‘ ‘i‘
dst1 = "hello", r1 = 0
dst2 = "", r2 = 22
dst3 = "good", r3 = 0

参考

C11标准（ISO / IEC 9899：2011）： 7.24.2.4 strncpy函数（p：363-364） K.3.7.1.4 strncpy_s函数（p：616-617） C99标准（ISO / IEC 9899：1999）： 7.21.2.4 strncpy函数（p：326-327） C89 / C90标准（ISO / IEC 9899：1990）： 4.11.2.4 strncpy函数

扩展内容

| 用于strncpy的C ++文档 |

??C 语言中文开发手册