.\" 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 seqüência 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 DESCRIÇÃO
A função \fBstpncpy\fP copia no máximo \fIn\fP caracteres da seqüência 
apontada por \fIsrc\fP, incluindo o caracter de  terminação '\\0', para
a cadeia apontada por \fIdest\fP. Exatamente \fIn\fP caracteres são
escritos em \fIdest\fP. Se o comprimento \fIstrlen(src)\fP é menor que
\fIn\fP, os caracteres restantes na cadeia apontada por \fIdest\fP são
preenchidos com caracteres '\\0'. Se o comprimento \fIstrlen(src)\fP é
maior ou igual a \fIn\fP, a seqüência apontada por \fIdest\fP não será 
terminada por '\\0'.
.PP
As cadeias de caracteres não podem se sobrepor.
.PP
O programador deve assegurar que há espaço para no mínimo \fIn\fP
caracteres em \fIdest\fP.
.SH "VALOR DE RETORNO"
\fBstpncpy\fP retorna um ponteiro para a terminação nula em \fIdest\fP,
ou, se \fIdest\fP não é terminado por '\\0', \fIdest + n\fP.
.SH "CONFORMIDADE"
Esta função é uma extensão GNU.
.SH "VEJA TAMBÉM"
.BR strncpy (3)
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWKenzo Marcelo Okamura <kenzo.okamura@poli.usp.br> (tradução)\fR
\&\fR\&\f(CWxxxxx <xxxxx@xxx.xxx.xx> (revisão)\fR