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.
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)