.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" Traducida por Pedro Pablo Fábrega <pfabrega@arrakis.es>
.\" Esto es documentación libre; puede redistribuirla y/o
.\" modificarla bajo los términos de la Licencia Pública General GNU
.\" publicada por la Free Software Foundation; bien la versión 2 de
.\" la Licencia o (a su elección) cualquier versión posterior.
.\"
.\" Referencias consultadas:
.\"   código fuente y manual de glibc-2 GNU
.\"   referencia de la bibliote C Dinkumware http://www.dinkumware.com/
.\"   Especificaciones Single Unix de OpenGroup http://www.UNIX-systems.org/onl
.\"
.\" Translation revised Wed Aug  2 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH WCPCPY 3  "25 julio 1999" "GNU" "Manual del Programador Linux"
.SH NOMBRE
wcpcpy \- copia una cadena de caracteres anchos, devolviendo un puntero
a su final
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "wchar_t *wcpcpy (wchar_t *" dest ", const wchar_t *" src );
.fi
.SH DESCRIPCIÓN
La función \fBwcpcpy\fP  es el equivalente de caracteres anchos de
la función \fBstpcpy\fP. Copia la cadena de caracteres anchos 
apuntada por \fIsrc\fP, incluyendo el carácter de terminación
L'\\0' en la cadena apuntada por 
\fIdest\fP.
.PP
Las cadenas no se pueden solapar.

.PP
El programador tiene que asegurarse de que hay espacio para, al menos,
\fIwcslen(src)+1\fP caracteres anchos en \fIdest\fP.
.SH "VALOR DEVUELTO"
\fBwcpcpy\fP devuelve un puntero al final de la cadena de caracteres 
anchos \fIdest\fP, esto es, un puntero al carácter de 
terminación L'\\0'.
.SH "CONFORME A"
Esta función  es una extensión GNU.
.SH "VÉASE TAMBIÉN"
.BR strcpy "(3), " wcscpy (3)