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)