C

strncpy

strncpy, strncpy_s

在头文件中定义
(1)
char * strncpy(char * dest,const char * src,size_t count);(直到C99)
char * strncpy(char * restrict dest,const char * restrict src,size_t count);(自C99以来)
errno_t strncpy_s(char * restrict dest,rsize_t destsz,const char * restrict src,rsize_t count);(2)(自C11以来)

1)将由src指向的字符数组的大部分计数字符(包括终止空字符,但不包括空字符后面的任何字符)复制到由dest指向的字符数组。

如果在复制完整个数组src之前达到count,则生成的字符数组不会以null结尾。

如果在复制src中的终止空字符之后,未达到count,则将额外的空字符写入dest,直到写入总计数字符。

如果字符数组重叠,如果dest或src不是指向字符数组的指针(包括如果dest或src是空指针),如果dest指向的数组大小小于count,则行为未定义, 或者如果src指向的数组大小小于count并且不包含空字符。

2)与(1)相同,除了该函数不会继续将零写入目标数组以填充计数,它将在写入终止空字符后停止(如果源中没有空值,它将在dest处写入一个 [count]然后停止)。 此外,在运行时检测到以下错误并调用当前安装的约束处理函数:

  • src或者dest是空指针

如果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才能保证可用。

参数

dest-指向要复制到的字符数组的指针
SRC-指向要复制的字符数组的指针
count-最大数量的字符复制
destsz-目标缓冲区的大小

返回值

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):

扩展内容

strcpystrcpy_s(C11)将一个字符串复制到另一个(函数)
memcpymemcpy_s(C11)将一个缓冲区复制到另一个(功能)
strndup (dynamic memory TR) 将字符串的副本分配给指定大小(函数)

| 用于strncpy的C ++文档 |