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.

CONFORMIDADE

       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)

GNU                                               July 25, 1999                                       STPNCPY(3)