NOME

btowc - converte um byte para um caracter largo

BIBLIOTECA

Biblioteca C Padrão (libc, -lc)

SINOPSE

#include <wchar.h>

wint_t btowc(int c);

DESCRIÇÃO

A função btowc() converte c, tratada como uma sequência multibyte de comprimento 1, começando no estado transitório inicial, para um caractere largo e o retorna. Se c for EOF (fim de linha) ou não for uma sequencia multibyte de comprimento 1 válida, retorna WEOF.

VALOR DE RETORNO

A função btowc() retorna o caractere largo convertido a partir do c de byte único. Se c for EOF ou não for uma sequência multibyte de comprimento 1 válida, retorna WEOF.

ATRIBUTOS

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

PADRÕES

C11, POSIX.1-2008.

HISTÓRICO

C99, POSIX.1-2001.

NOTAS

O comportamento de btowc() depende da categoria LC_TYPE na localidade atual.

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 mbtowc(3) ou a segura para thread mbrtowc(3).

VEJA TAMBÉM

mbrtowc(3), mbtowc(3), wctob(3)

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

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.