.\" -*- 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
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH btowc 3 "20 julho 2023" "Linux man\-pages 6.05.01" 
.SH NOME
btowc \- converte um byte para um caracter largo
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP, \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <wchar.h>\fP
.PP
\fBwint_t btowc(int \fP\fIc\fP\fB);\fP
.fi
.SH DESCRIÇÃO
A função \fBbtowc\fP() converte \fIc\fP, tratada como uma sequência multibyte de
comprimento 1, começando no estado transitório inicial, para um caractere
largo e o retorna. Se \fIc\fP for \fBEOF\fP (fim de linha) ou não for uma
sequencia multibyte de comprimento 1 válida, retorna \fBWEOF\fP.
.SH "VALOR DE RETORNO"
A função \fBbtowc\fP() retorna o caractere largo convertido a partir do \fIc\fP de
byte único. Se \fIc\fP for \fBEOF\fP ou não for uma sequência multibyte de
comprimento 1 válida, retorna \fBWEOF\fP.
.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
\fBbtowc\fP()
T}	Thread safety	MT\-Safe
.TE
.sp 1
.SH PADRÕES
C11, POSIX.1\-2008.
.SH HISTÓRICO
C99, POSIX.1\-2001.
.SH NOTAS
O comportamento de \fBbtowc\fP() depende da categoria \fBLC_TYPE\fP na localidade
atual.
.PP
Esta função não deve nunca ser usada. Ela não funciona para codificações que
têm estado, e trata bytes únicos como sequências multibyte sem
necessidade. Use a função \fBmbtowc\fP(3) ou a segura para thread
\fBmbrtowc\fP(3).
.SH "VEJA TAMBÉM"
\fBmbrtowc\fP(3), \fBmbtowc\fP(3), \fBwctob\fP(3)
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Paulo César Mendes <drpc@ism.com.br>,
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 .