summaryrefslogtreecommitdiffstats
path: root/man3/wcscpy.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/wcscpy.3')
-rw-r--r--man3/wcscpy.342
1 files changed, 42 insertions, 0 deletions
diff --git a/man3/wcscpy.3 b/man3/wcscpy.3
new file mode 100644
index 000000000..a64919ece
--- /dev/null
+++ b/man3/wcscpy.3
@@ -0,0 +1,42 @@
+.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
+.\"
+.\" 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.
+.\"
+.\" 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
+.\" ISO/IEC 9899:1999
+.\"
+.TH WCSCPY 3 1999-07-25 "GNU" "Linux Programmer's Manual"
+.SH NAME
+wcscpy \- copy a wide character string
+.SH SYNOPSIS
+.nf
+.B #include <wchar.h>
+.sp
+.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.
+.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"
+.BR strcpy (3),
+.BR wcpcpy (3),
+.BR wcscat (3),
+.BR wcsdup (3),
+.BR wmemcpy (3)