NOME

       fputwc, putwc - escreve um caractere largo em um fluxo de arquivo

BIBLIOTECA

       Biblioteca C Padrão (libc, -lc)

SINOPSE

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

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

DESCRIÇÃO

       A função fputwc() é o equivalente para caracteres largos da função fputc(3). 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.

       Para contrapartes não bloqueantes, veja unlocked_stdio(3).

VALOR DE RETORNO

       On success, fputwc()  function returns wc.  Otherwise, WEOF is returned, and errno is  set
       to indicate the error.

ERROS

       Além dos normais, há

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

ATRIBUTOS

       Para uma explicação dos termos usados nesta seção, consulte attributes(7).

       ┌───────────────────────────────────────────────────────────────┬───────────────┬─────────┐
       │Interface                                                      │ Atributo      │ Valor   │
       ├───────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │fputwc(), putwc()                                              │ Thread safety │ MT-Safe │
       └───────────────────────────────────────────────────────────────┴───────────────┴─────────┘

PADRÕES

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

NOTAS

       O comportamento de fputwc() depende da categoria LC_CTYPE da localização atual.

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

VEJA TAMBÉM

       fgetwc(3), fputws(3), unlocked_stdio(3)

TRADUÇÃO

       A  tradução  para  português  brasileiro  desta  página man foi criada por Rubens de Jesus
       Nogueira <darkseid99@usa.net> e André Luiz Fassone <lonely_wolf@ig.com.br>

       Esta tradução é uma documentação  livre;  leia  a  Licença  Pública  Geral  GNU  Versão  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩  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 ⟨debian-l10n-portuguese@lists.debian.org⟩.