Linux程序员手册 第3部分
更新日期： 2019-03-06

名称

stpncpy-复制固定大小的字符串，并返回一个指向其结尾的指针

语法

#include <string.h>

char *stpncpy(char *dest, const char *src, size_t n);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

stpncpy()：

Since glibc 2.10:

_POSIX_C_SOURCE>= 200809L

Before glibc 2.10:

_GNU_SOURCE

说明

stpncpy()函数最多将n个字符从src指向的字符串(包括终止的空字节(aq \ 0aq))复制到dest指向的数组。 dest上恰好写入了n个字符。如果长度strlen(src)小于n，则dest指向的数组中的剩余字符将填充为空字节(aq \ 0aq)；如果长度strlen(src)大于或等于n，则字符串dest所指向的字符将不会为空终止。

字符串可能不会重叠。

程序员必须确保目标处至少有n个字符的空间。

返回值

stpncpy()返回一个指针，该指针指向dest中的终止空字节，或者，如果dest不是终止于空的字节，则返回dest + n。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

此功能已添加到POSIX.1-2008。在此之前，它是GNU扩展。它于1993年首次出现在GNU C库的1.07版中。

另外参见

strncpy(3)，wcpncpy(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。