NOME

       fputwc - escreve um caractere largo em um fluxo de arquivo

SINOPSE

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

       wint_t fputwc (wchar_t wc, FILE* stream);
       wint_t putwc (wchar_t wc, FILE* stream);

DESCRIÇÃO

       A  função  fputwc  é  o equivalente para caracteres largos da função fputc.  Ela escreve o
       caractere largo wc em stream. Se ferror(stream) é verdadeiro, ela retorna WEOF. Se  ocorre
       um  erro de conversão de caractere largo, ele seta errno para EILSEQ e retorna WEOF.  Caso
       contrário ela retorna wc.

       A função ou macro putwc funciona de forma idêntica a fputwc.  Ela  pode  ser  implementada
       como  uma  macro,  e  pode avaliar seu argumento mais de uma vez.  Não há razão ainda para
       usá-la.

VALOR DE RETORNO

       A função fputwc retorna wc se não ocorreu erro, ou WEOF para indicar um erro.

ERROS

       À parte dos erros normais, há

       EILSEQ A conversão de wc para a codificação do fluxo falhou.

CONFORME

       ISO/ANSI C, UNIX98

VEJA TAMBÉM

       fgetwc(3), fputws(3)

NOTAS

       O comportamento de fputwc depende da categoria LC_CTYPE do 'locale' corrente.

       Na ausência de informações adicionais passadas para  a  chamada  de  'fopen',  é  razoável
       esperar  que  fputwc  escreverá a sequência multibyte correspondente aos caracteres largos
       wc.

TRADUÇÃO PARA A LÍNGUA PORTUGUESA

       RUBENS  DE  JESUS  NOGUEIRA  <darkseid99@usa.net>  (tradução)  XXXXXX  XX  XXXXX  XXXXXXXX
       <xxxxxxxxxx@xxx.xxx> (revisão)