.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
-.\" %%%LICENSE_START(GPLv2+_ONEPARA)
+.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" Dinkumware C library reference http://www.dinkumware.com/
.\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"
-.TH WCPNCPY 3 2011-10-01 "GNU" "Linux Programmer's Manual"
+.TH WCPNCPY 3 2016-03-15 "GNU" "Linux Programmer's Manual"
.SH NAME
wcpncpy \- copy a fixed-size string of wide characters,
returning a pointer to its end
.RS 4
.TP 4
Since glibc 2.10:
-_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
+_POSIX_C_SOURCE\ >=\ 200809L
.TP
Before glibc 2.10:
_GNU_SOURCE
of the
.BR stpncpy (3)
function.
-It copies at most \fIn\fP wide characters from the wide-character
-string pointed to by \fIsrc\fP,
+It copies at most
+.I n
+wide characters from the wide-character
+string pointed to by
+.IR src ,
including the terminating null wide (L\(aq\\0\(aq),
-to the array pointed to by \fIdest\fP.
-Exactly \fIn\fP wide characters are
-written at \fIdest\fP.
-If the length \fIwcslen(src)\fP is smaller than \fIn\fP,
+to the array pointed to by
+.IR dest .
+Exactly
+.I n
+wide characters are
+written at
+.IR dest .
+If the length
+.IR wcslen(src)
+is smaller than
+.IR n ,
the remaining wide characters in the array pointed to
-by \fIdest\fP are filled with L\(aq\\0\(aq characters.
-If the length \fIwcslen(src)\fP is greater or equal
-to \fIn\fP, the string pointed to by \fIdest\fP will
+by
+.I dest
+are filled with L\(aq\\0\(aq characters.
+If the length
+.IR wcslen(src)
+is greater than or equal
+to
+.IR n ,
+the string pointed to by
+.I dest
+will
not be L\(aq\\0\(aq terminated.
.PP
The strings may not overlap.
.PP
-The programmer must ensure that there is room for at least \fIn\fP wide
-characters at \fIdest\fP.
+The programmer must ensure that there is room for at least
+.I n
+wide
+characters at
+.IR dest .
.SH RETURN VALUE
.BR wcpncpy ()
returns a pointer to the last wide character written, that is,
-\fIdest + n \- 1\fP.
+.IR dest + n \-1.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface Attribute Value
+T{
+.BR wcpncpy ()
+T} Thread safety MT-Safe
+.TE
.SH CONFORMING TO
POSIX.1-2008.
.SH SEE ALSO