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)