FPUTWC(3)

NOME
fputwc - escreve um caractere largo em um fluxo de arquivo

SINÓPSE
#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.

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

ERROS
À parte dos erros normais, há

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

DE ACORDO COM
ISO/ANSI C, UNIX98.

VEJA TAMBÉM
fgetwc(3), fputws(3).

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', é razoável esperar que fputwc escreverá a sequência multibyte correspondente aos caracteres largos wc.

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

  Tradução:
Rubens de Jesus Nogueira <darkseid99@usa.net>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>