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

       Em caso de sucesso, a função fputwc() retorna wc. Do contrário, WEOF é retornado e errno é definido  para
       indicar o erro.

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

       C11, POSIX.1-2008.

HISTÓRICO

       C99, POSIX.1-2001.

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>,    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                                         fputwc(3)