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

名称

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

语法

#include <wchar.h>

wchar_t *wcpncpy(wchar_t *dest, const wchar_t *src, size_t n);

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

wcpncpy()：

Since glibc 2.10:

_POSIX_C_SOURCE>= 200809L

Before glibc 2.10:

_GNU_SOURCE

说明

wcpncpy()函数与stpncpy(3)函数的宽字符等效。它最多将n个宽字符从src指向的宽字符字符串(包括终止的null宽(Laq \ 0aq))复制到dest指向的数组。 d个字符恰好写了n个宽字符。如果长度wcslen(src)小于n，则dest指向的数组中其余的宽字符将用Laq \ 0aq字符填充。如果长度wcslen(src)大于或等于n，则dest指向的字符串将不会以Laq \ 0aq终止。

字符串可能不会重叠。

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

返回值

wcpncpy()返回指向最后写入的宽字符的指针，即dest + n-1。

属性

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

遵循规范

POSIX.1-2008。

另外参见

stpncpy(3)，wcsncpy(3)

出版信息

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