.\" 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 WCSNCPY 3  "25 Julho 1999" "GNU" "Manual do Programador Linux"
.SH NOME
wcsncpy \- copia uma string de caracteres largos de tamanho fixo
.SH SINOPSE
.nf
.B #include <wchar.h>
.sp
.BI "wchar_t *wcsncpy (wchar_t *" dest ", const wchar_t *" src ", size_t " n );
.fi
.SH DESCRIÇÃO
A função \fBwcsncpy\fP é a equivalente para caracteres largos da função
\fBstrncpy\fP. Copia no máximo \fIn\fP caracteres largos da cadeia de
caracteres largos apontada por \fIsrc\fP, incluindo o caractere terminador
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 suficiente para pelo menos \fIn\fP
caracteres largos em \fIdest\fP.
.SH "VALOR DE RETORNO"
\fBwcsncpy\fP retorna \fIdest\fP.
.SH "CONFORMIDADE"
ISO/ANSI C, UNIX98
.SH "VEJA TAMBÉM"
.BR strncpy (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