.\" 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
.\"
.TH WCPNCPY 3  "25 Julho 1999" "GNU" "Manual do Programador Linux"
.SH NOME
wcpncpy \- copia uma string de tamanho determinado de caracteres largos, retornando um ponteiro para o seu final
.SH SINOPSE
.nf
.B #include <wchar.h>
.sp
.BI "wchar_t *wcpncpy (wchar_t *" dest ", const wchar_t *" src ", size_t " n );
.fi
.SH DESCRIÇÃO
A função \fBwcpncpy\fP é a equivalente para caracteres largos da função
\fBstpncpy\fP. Copia no máximo \fIn\fP caracteres largos da string de
caracteres largos apontada por \fIsrc\fP, incluindo o caractere de terminação
L'\\0', para o vetor apontado por \fIdest\fP. Exatamente \fIn\fP caracteres
largos são escritos em \fIdest\fP. Se o tamanho de \fIwcslen(src)\fP é menor
que \fIn\fP, os caracteres largos restantes no vetor apontado por \fIdest\fP
são preenchidos com caracteres L'\\0'. Se o tamanho de \fIwcslen(src)\fP é
maior ou igual a \fIn\fP, a string apontada por \fIdest\fP não será terminada
por L'\\0'.
.PP
As strings não podem se sobrepor.
.PP
O programador deve assegurar que há espaço para pelo menos \fIn\fP caracteres
largos em \fIdest\fP.
.SH "VALOR DE RETORNO"
\fBwcpncpy\fP retorna um ponteiro para os últimos caracteres largos escritos,
isto é, \fIdest + n - 1\fP.
.SH "CONFORMIDADE"
Esta função é uma extensão GNU.
.SH "VEJA TAMBÉM"
.BR stpncpy "(3), " wcsncpy (3)
.SH TRADUZIDO POR LDP-BR em 25/08/2000
\&\fR\&\f(CWMarcelo D. Beckmann <marcelobeckmann@yahoo.com> (tradução)\fR
\&\fR\&\f(CWEspaço para o Revisor <nome@dominio.com.br> (revisão)\fR