NOME¶

wcpncpy - copia uma string de caracteres largos de tamanho fixo, retornando um ponteiro para o seu final

SINOPSE¶

#include <wchar.h>

wchar_t *wcpncpy(wchar_t *dest, const wchar_t *src, size_t n);

Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

wcpncpy():

DESCRIÇÃO¶

A função wcpncpy() é a equivalente para caracteres largos da função stpncpy(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 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.

ATRIBUTOS¶

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

DE ACORDO COM¶

POSIX.1-2008.

VEJA TAMBÉM¶

stpncpy(3), wcsncpy(3)

COLOFÃO¶

Esta página faz parte da versão 4.16 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.