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
|
.\" 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
.\"
.\" Corrected, aeb, 990824
.TH STPNCPY 3 "July 25, 1999" "GNU" "Manual do Programador Linux"
.SH NOME
stpncpy \- copia uma seqncia de caracteres de tamanho fixo,
retornando um ponteiro para o seu final
.SH SINOPSE
.nf
.B #include <string.h>
.sp
.BI "char *stpncpy (char *" dest ", const char *" src ", size_t " n );
.fi
.SH DESCRIO
A funo \fBstpncpy\fP copia no mximo \fIn\fP caracteres da seqncia
apontada por \fIsrc\fP, incluindo o caracter de terminao '\\0', para
a cadeia apontada por \fIdest\fP. Exatamente \fIn\fP caracteres so
escritos em \fIdest\fP. Se o comprimento \fIstrlen(src)\fP menor que
\fIn\fP, os caracteres restantes na cadeia apontada por \fIdest\fP so
preenchidos com caracteres '\\0'. Se o comprimento \fIstrlen(src)\fP
maior ou igual a \fIn\fP, a seqncia apontada por \fIdest\fP no ser
terminada por '\\0'.
.PP
As cadeias de caracteres no podem se sobrepor.
.PP
O programador deve assegurar que h espao para no mnimo \fIn\fP
caracteres em \fIdest\fP.
.SH "VALOR DE RETORNO"
\fBstpncpy\fP retorna um ponteiro para a terminao nula em \fIdest\fP,
ou, se \fIdest\fP no terminado por '\\0', \fIdest + n\fP.
.SH "CONFORMIDADE"
Esta funo uma extenso GNU.
.SH "VEJA TAMBM"
.BR strncpy (3)
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWKenzo Marcelo Okamura <kenzo.okamura@poli.usp.br> (traduo)\fR
\&\fR\&\f(CWxxxxx <xxxxx@xxx.xxx.xx> (reviso)\fR
|