.\" 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 WCPNCPY 3  "25 julio 1999" "GNU" "Manual del Programador Linux"
.SH NOMBRE
wcpncpy \- copia una cadena de caracteres anchos de tamaño fijo,
devolviendo un puntero a su final
.SH SINOPSIS
.nf
.B #include <wchar.h>
.sp
.BI "wchar_t *wcpncpy (wchar_t *" dest ", const wchar_t *" src ", size_t " n );
.fi
.SH DESCRIPCIÓN
La función \fBwcpncpy\fP  es el equivalente de caracteres anchos de
la función \fBstpncpy\fP. Copia, a lo sumo \fIn\fP caracteres
anchos de 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.
Se escriben exactamente  \fIn\fP caracteres en \fIdest\fP. 
Si la longitud  \fIwcslen(src)\fP es menor que \fIn\fP,
el resto de caracteres anchos apuntados por  \fIdest\fP se rellenan
con caracteres L'\\0'. Si la longitud \fIwcslen(src)\fP es mayor 
o igual que \fIn\fP, la cadena apuntada por \fIdest\fP no estará
terminada en L'\\0'.
.PP
Las cadenas no se pueden solapar.
.PP
El programador tiene que asegurarse de que hay espacio para, al menos,
\fIn\fP caracteres anchos en \fIdest\fP.
.SH "VALOR DEVUELTO"
\fBwcpncpy\fP devuelve un puntero al último carácter ancho
escrito, esto es, final de la cadena de caracteres
anchos \fIdest + n - 1\fP.
.SH "CONFORME A"
Esta función es una extensión GNU.
.SH "VÉASE TAMBIÉN"
.BR stpncpy "(3), " wcsncpy (3)