NOME

       btowc - converte um byte para um caracter largo

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).
       ┌───────────┬───────────────┬─────────┐
       │ Interface │ Atributo      │ Valor   │
       ├───────────┼───────────────┼─────────┤
       │ btowc()   │ Thread safety │ MT-Safe │
       └───────────┴───────────────┴─────────┘

DE ACORDO COM

       POSIX.1-2001, POSIX.1-2008, C99.

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)

COLOFÃO

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

GNU                                               8 agosto 2015                                         BTOWC(3)