NOMBRE

       fputwc - escribe un carácter ancho en un flujo FILE

SINOPSIS

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

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

DESCRIPCIÓN

       La  función  fputwc  es  equivalente para caracteres anchos a la función fputc. La función
       escribe el carácter ancho wc en stream. Si ferror(stream) es cierto, devuelve WEOF. Si  se
       produce  un  error en la conversión de caracteres anchos, asigna a errno el valor EILSEQ y
       devuelve WEOF. En otro caso, devuelve wc.

       La función o macro putwc funciona de la misma forma que fputwc.  Se puede implementar como
       una macro y puede evaluar su argumento más de una vez. Nunca hay razón para utilizarla.

       Para las versiones no-bloqueantes, véase unlocked_stdio(3).

VALOR DEVUELTO

       La  función  fputwc devuelve wc si no se ha producido ningún error, o WEOF para indicar un
       error.

ERRORES

       Aparte de los usuales, existe

       EILSEQ Ha fallado la conversión de wc a la codificación del flujo.

CONFORME A

       ISO/ANSI C, UNIX98

OBSERVACIONES

       El comportamiento de fputwc depende de la categoría LC_CTYPE de la localización actual.

       En ausencia de información adicional pasada a la llamada fopen, es razonable  esperar  que
       fputwc escriba realmente la secuencia multibyte correspondiente al carácter ancho wc.

VÉASE TAMBIÉN

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