NOME

wcsncpy - copia uma string de caracteres largos de tamanho fixo

BIBLIOTECA

Biblioteca C Padrão (libc, -lc)

SINOPSE

#include <wchar.h>

wchar_t *wcsncpy(wchar_t dest[restrict .n],
                 const wchar_t src[restrict .n],
                 size_t n);

DESCRIÇÃO

The wcsncpy() function is the wide-character equivalent of the strncpy(3) function. It copies at most n wide characters from the wide-character string pointed to by src, including the terminating null wide character (L'\0'), to the array pointed to by dest. Exactly n wide characters are written at dest. If the length wcslen(src) is smaller than n, the remaining wide characters in the array pointed to by dest are filled with null wide characters. If the length wcslen(src) is greater than or equal to n, the string pointed to by dest will not be terminated by a null wide character.

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).

PADRÕES

C11, POSIX.1-2008.

HISTÓRICO

POSIX.1-2001, C99.

VEJA TAMBÉM

strncpy(3)

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.