fgetwc(3)                  Library Functions Manual                  fgetwc(3)

NOME
       fgetwc, getwc - le um caractere largo a partir de um fluxo de arquivo

BIBLIOTECA
       Biblioteca C Padrao (libc, -lc)

SINOPSE
       #include <stdio.h>
       #include <wchar.h>

       wint_t fgetwc(FILE *fluxo);
       wint_t getwc(FILE *fluxo);

DESCRICAO
       A funcao fgetwc() e a equivalente para caracteres largos da funcao
       fgetc(3). Ela le um caractere largo a partir de fluxo e o retorna. Se o
       fim do fluxo e encontrado, ou se ferror(stream) se torna verdadeiro,
       ela retorna WEOF. Se ocorre um erro de conversao para caracteres
       largos, ela seleciona errno para EILSEQ e retorna WEOF.

       A funcao ou macro getwc() funciona de forma identica a fgetwc(). Ela
       pode ser implementada como uma macro, e pode avaliar seu argumento mais
       de uma vez. Nao ha razao ainda para usa-la.

       Para contrapartes nao bloqueantes, veja unlocked_stdio(3).

VALOR DE RETORNO
       No caso de sucesso, fgetwc() retorna o proximo caractere largo que vem
       do fluxo. Do contrario, WEOF e retornado e errno e definido para
       indicar o erro.

ERROS
       Alem dos normais, ha

       EILSEQ Os dados obtidos a partir do fluxo de entrada nao formam um
              caractere valido.

ATRIBUTOS
       Para uma explicacao dos termos usados nesta secao, consulte
       attributes(7).

       +--------------------------------------------+---------------+---------+
       |Interface                                   | Atributo      | Valor   |
       +--------------------------------------------+---------------+---------+
       |fgetwc(), getwc()                           | Thread safety | MT-Safe |
       +--------------------------------------------+---------------+---------+
PADROES
       C11, POSIX.1-2008.

HISTORICO
       POSIX.1-2001, C99.

NOTAS
       O comportamento de fgetwc() depende da categoria LC_CTYPE da
       localizacao atual.

       Na ausencia de informacoes adicionais passadas para a chamada de
       fopen(3), e razoavel esperar que fgetwc() ira ler no momento uma
       sequencia multibyte a partir do fluxo e entao converte-la para
       caracteres largos.

VEJA TAMBEM
       fgetws(3), fputwc(3), ungetwc(3), unlocked_stdio(3)

TRADUCAO
       A traducao para portugues brasileiro desta pagina man foi criada por
       Rubens de Jesus Nogueira <darkseid99@usa.net>, Andre Luiz Fassone
       <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

       Esta traducao e uma documentacao livre; leia a Licenca Publica Geral
       GNU Versao 3 <https://www.gnu.org/licenses/gpl-3.0.html> ou posterior
       para as condicoes de direitos autorais.  Nenhuma responsabilidade e
       aceita.

       Se voce encontrar algum erro na traducao desta pagina de manual, envie
       um e-mail para a lista de discussao de tradutores
       <debian-l10n-portuguese@lists.debian.org>.

Linux man-pages 6.06            31 outubro 2023                      fgetwc(3)