STPNCPY - Linux手册页

时间:2019-08-20 18:01:23  来源:igfitidea点击:

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

InterfaceAttributeValue
stpncpy()Thread safetyMT-Safe

遵循规范

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

另外参见

strncpy(3),wcpncpy(3)

出版信息

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