STPNCPY(3)

NOME
stpncpy - copia uma seqüência de caracteres de tamanho fixo, retornando um ponteiro para o seu final

SINÓPSE
#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.

VALORES RETORNADOS
stpncpy retorna um ponteiro para a terminação nula em dest, ou, se dest não é terminado por '\0', dest + n.

DE ACORDO COM
Esta função é uma extensão GNU.

VEJA TAMBÉM
strncpy(3).

TRADUZIDO POR LDP-BR em 21/08/2000.

  Tradução:
Kenzo Marcelo Okamura <kenzo.okamura@poli.usp.br>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>