Provided by: manpages-pt-dev_20040726-4_all bug

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 seqüência de bytes de
       comprimento 1, começando no  shift  state  inicial,  para  um  caracter
       completo  e  o  retorna.   Se  c  for  EOF  ou não for uma seqüencia de
       comprimento 1 válida, retorna WEOF.

VALOR RETORNADO

       A função btowc retorna o caracter completo gerado a partir do  byte  c.
       Se  c for EOF ou não for uma seqüência de comprimento 1 válida, retorna
       WEOF.

DE ACORDO COM

       ISO/ANSI C, UNIX98

SEE ALSO

       mbtowc(3)

OBSERVAÇÕES

       O comportamento desta função depende do LC_TYPE 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 seqüências de
       vários bytes desnecessariamente.  Use a função mbtowc.

TRADUZIDO POR LDP-BR em 21/08/2000.

       Paulo       César       Mendes       <drpc@ism.com.br>       (tradução)
       xxxxxxxxxxxxxxxxxxxxxxxxx <xxx@xxxxxx.xxx.xx> (revisão)