.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcpncpy 3 "20 julho 2023" "Linux man\-pages 6.05.01" 
.SH NOME
wcpncpy \- copia uma string de caracteres largos de tamanho fixo, retornando
um ponteiro para o seu final
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *wcpncpy(wchar_t \fP\fIdest\fP\fB[restrict .\fP\fIn\fP\fB],\fP
\fB                 const wchar_t \fP\fIsrc\fP\fB[restrict .\fP\fIn\fP\fB],\fP
\fB                 size_t \fP\fIn\fP\fB);\fP
.fi
.PP
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\fBfeature_test_macros\fP(7)):
.RE
.PP
\fBwcpncpy\fP():
.nf
    Desde o glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    Antes do glibc 2.10:
        _GNU_SOURCE
.fi
.SH DESCRIÇÃO
The \fBwcpncpy\fP()  function is the wide\-character equivalent of the
\fBstpncpy\fP(3)  function.  It copies at most \fIn\fP wide characters from the
wide\-character string pointed to by \fIsrc\fP, including the terminating null
wide (L\[aq]\e0\[aq]), to the array pointed to by \fIdest\fP.  Exactly \fIn\fP
wide characters are written at \fIdest\fP.  If the length \fIwcslen(src)\fP is
smaller than \fIn\fP, the remaining wide characters in the array pointed to by
\fIdest\fP are filled with L\[aq]\e0\[aq] characters.  If the length
\fIwcslen(src)\fP is greater than or equal to \fIn\fP, the string pointed to by
\fIdest\fP will not be L\[aq]\e0\[aq] terminated.
.PP
As strings não podem se sobrepor.
.PP
O programador deve assegurar que há espaço para pelo menos \fIn\fP caracteres
largos em \fIdest\fP.
.SH "VALOR DE RETORNO"
\fBwcpncpy\fP() retorna um ponteiro para os últimos caracteres largos escritos,
isto é, \fIdest\fP+\fIn\fP\-1.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Atributo	Valor
T{
.na
.nh
\fBwcpncpy\fP()
T}	Thread safety	MT\-Safe
.TE
.sp 1
.SH PADRÕES
POSIX.1\-2008.
.SH "VEJA TAMBÉM"
\fBstpncpy\fP(3), \fBwcsncpy\fP(3)
.PP
.SH 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>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .