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.

CONFORMIDADE

       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)