NOME¶
wcpncpy - copia uma string de tamanho determinado de caracteres largos,
retornando um ponteiro para o seu final
SINOPSE¶
#include <wchar.h>
wchar_t *wcpncpy (wchar_t *dest, const wchar_t *src, size_t n);
DESCRIÇÃO¶
A função
wcpncpy é a equivalente para caracteres largos da
função
stpncpy. Copia no máximo
n caracteres
largos da string de caracteres largos apontada por
src, incluindo o
caractere de terminação L'\0', para o vetor apontado por
dest. Exatamente
n caracteres largos são escritos em
dest. Se o tamanho de
wcslen(src) é menor que
n, os
caracteres largos restantes no vetor apontado por
dest são
preenchidos com caracteres L'\0'. Se o tamanho de
wcslen(src) é
maior ou igual a
n, a string apontada por
dest não
será terminada por L'\0'.
As strings não podem se sobrepor.
O programador deve assegurar que há espaço para pelo menos
n
caracteres largos em
dest.
VALOR DE RETORNO¶
wcpncpy retorna um ponteiro para os últimos caracteres largos
escritos, isto é,
dest + n - 1.
Esta função é uma extensão GNU.
VEJA TAMBÉM¶
stpncpy(3),
wcsncpy(3)
TRADUZIDO POR LDP-BR em 25/08/2000¶
Marcelo D. Beckmann <marcelobeckmann@yahoo.com> (tradução)
Espaço para o Revisor <nome@dominio.com.br> (revisão)