NOME¶
stpncpy - copia uma seqüência de caracteres de tamanho fixo,
retornando um ponteiro para o seu final
SINOPSE¶
#include <string.h>
char *stpncpy (char *dest, const char *src, size_t n);
DESCRIÇÃO¶
A função
stpncpy copia no máximo
n caracteres da
seqüência apontada por
src, incluindo o caracter de
terminação '\0', para a cadeia apontada por
dest. Exatamente
n caracteres são escritos em
dest. Se o comprimento
strlen(src) é menor que
n, os caracteres restantes na
cadeia apontada por
dest são preenchidos com caracteres '\0'. Se o
comprimento
strlen(src) é maior ou igual a
n, a
seqüência apontada por
dest não será terminada por
'\0'.
As cadeias de caracteres não podem se sobrepor.
O programador deve assegurar que há espaço para no mínimo
n caracteres em
dest.
VALOR DE RETORNO¶
stpncpy retorna um ponteiro para a terminação nula em
dest, ou, se
dest não é terminado por '\0',
dest +
n.
Esta função é uma extensão GNU.
VEJA TAMBÉM¶
strncpy(3)
TRADUZIDO POR LDP-BR em 21/08/2000.¶
Kenzo Marcelo Okamura <kenzo.okamura@poli.usp.br> (tradução)
xxxxx <xxxxx@xxx.xxx.xx> (revisão)