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)