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(3). Copia no máximo n caracteres largos da string de caracteres largos apontada por src, incluindo o caractere largo nulo de terminação (L'\0'), para o array 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 array apontado por dest são preenchidos com caracteres largos nulos. Se o tamanho de wcslen(src) é maior ou igual a n, a string apontada por dest não será terminada por um caractere largo nulo.

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¶

wcsncpy() retorna dest.

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

DE ACORDO COM¶

POSIX.1-2001, POSIX.1-2008, C99.

VEJA TAMBÉM¶

strncpy(3)

COLOFÃO¶

Esta página faz parte da versão 5.10 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Marcelo D. Beckmann <marcelobeckmann@yahoo.com>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.