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
TRADUZIDO POR LDP-BR em 21/08/2000.
Kenzo Marcelo Okamura <kenzo.okamura [AT] poli.br> (tradução) xxxxx <xxxxx [AT] xxx.xx> (revisão)