]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/wcscpy.3
Changes: Ready for 5.02
[thirdparty/man-pages.git] / man3 / wcscpy.3
index 6d41c03df3d018300b98912e18e9d87f80891c14..70f6342e901b01e30e6e2235d40e39f4df765635 100644 (file)
@@ -1,40 +1,66 @@
 .\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
 .\"
+.\" %%%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
 .\" the License, or (at your option) any later version.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"   GNU glibc-2 source code and manual
 .\"   Dinkumware C library reference http://www.dinkumware.com/
-.\"   OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
+.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
 .\"   ISO/IEC 9899:1999
 .\"
-.TH WCSCPY 3  1999-07-25 "GNU" "Linux Programmer's Manual"
+.TH WCSCPY 3  2019-03-06 "GNU" "Linux Programmer's Manual"
 .SH NAME
-wcscpy \- copy a wide character string
+wcscpy \- copy a wide-character string
 .SH SYNOPSIS
 .nf
 .B #include <wchar.h>
-.sp
+.PP
 .BI "wchar_t *wcscpy(wchar_t *" dest ", const wchar_t *" src );
 .fi
 .SH DESCRIPTION
-The \fBwcscpy\fP() function is the wide-character equivalent of the \fBstrcpy\fP()
-function. It copies the wide character string pointed to by \fIsrc\fP,
-including the terminating L'\\0' character, to the array pointed to by
-\fIdest\fP.
+The
+.BR wcscpy ()
+function is the wide-character equivalent
+of the
+.BR strcpy (3)
+function.
+It copies the wide-character string pointed to by
+.IR src ,
+including the terminating null wide character (L\(aq\e0\(aq),
+to the array pointed to by
+.IR dest .
 .PP
 The strings may not overlap.
 .PP
-The programmer must ensure that there is room for at least \fIwcslen(src)+1\fP
-wide characters at \fIdest\fP.
-.SH "RETURN VALUE"
-\fBwcscpy\fP() returns \fIdest\fP.
-.SH "CONFORMING TO"
-ISO/ANSI C, UNIX98
-.SH "SEE ALSO"
+The programmer must ensure that there is
+room for at least
+.IR "wcslen(src)+1"
+wide characters at
+.IR dest .
+.SH RETURN VALUE
+.BR wcscpy ()
+returns
+.IR dest .
+.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 wcscpy ()
+T}     Thread safety   MT-Safe
+.TE
+.SH CONFORMING TO
+POSIX.1-2001, POSIX.1-2008, C99.
+.SH SEE ALSO
 .BR strcpy (3),
 .BR wcpcpy (3),
 .BR wcscat (3),