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
       sequência 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 │
       └─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

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.

Linux man-pages 6.9.1                              2 maio 2024                                          btowc(3)