1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46
|
.\" 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 DESCRIO
A funo \fBwcpncpy\fP a equivalente para caracteres largos da funo
\fBstpncpy\fP. Copia no mximo \fIn\fP caracteres largos da string de
caracteres largos apontada por \fIsrc\fP, incluindo o caractere de terminao
L'\\0', para o vetor apontado por \fIdest\fP. Exatamente \fIn\fP caracteres
largos so 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
so preenchidos com caracteres L'\\0'. Se o tamanho de \fIwcslen(src)\fP
maior ou igual a \fIn\fP, a string apontada por \fIdest\fP no ser terminada
por L'\\0'.
.PP
As strings no podem se sobrepor.
.PP
O programador deve assegurar que h espao 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 funo uma extenso GNU.
.SH "VEJA TAMBM"
.BR stpncpy "(3), " wcsncpy (3)
.SH TRADUZIDO POR LDP-BR em 25/08/2000
\&\fR\&\f(CWMarcelo D. Beckmann <marcelobeckmann@yahoo.com> (traduo)\fR
\&\fR\&\f(CWEspao para o Revisor <nome@dominio.com.br> (reviso)\fR
|