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)