NOME¶
wcsncpy - copia uma string de caracteres largos de tamanho fixo
SINOPSE¶
#include <wchar.h>
wchar_t *wcsncpy (wchar_t *dest, const wchar_t *src, size_t n);
DESCRIÇÃO¶
A função
wcsncpy é a equivalente para caracteres
largos da função
strncpy. Copia no máximo
n
caracteres largos da cadeia de caracteres largos apontada por
src,
incluindo o caractere terminador 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 suficiente para pelo
menos
n caracteres largos em
dest.
VALOR DE RETORNO¶
wcsncpy retorna
dest.
ISO/ANSI C, UNIX98
VEJA TAMBÉM¶
strncpy(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)