NOMBRE¶
fgetwc, getwc - leen un carácter ancho de un flujo FILE
SINOPSIS¶
#include <stdio.h>
#include <wchar.h>
wint_t fgetwc (FILE* stream);
wint_t getwc (FILE* stream);
DESCRIPCIÓN¶
La función
fgetwc es equivalente para caracteres anchos a la
función
fgetc. La función lee un carácter ancho de
stream y lo devuelve como resultado. Si se llega al final del flujo o
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.
La función o macro
getwc funciona de la misma forma que
fgetwc. Se puede implementar como una macro y puede evaluar su
argumento más de una vez. Nunca hay razón para usarla.
Para las versiones no-bloqueantes, véase
unlocked_stdio(3).
VALOR DEVUELTO¶
La función
fgetwc devuelve el siguiente carácter ancho del
flujo o WEOF.
ERRORES¶
Aparte de los habituales, existe
- EILSEQ
- Los datos obtenidos del flujo de entrada no forman un
carácter ancho válido.
ISO/ANSI C, UNIX98
VÉASE TAMBIÉN¶
fputwc(3),
fgetws(3),
ungetwc(3),
unlocked_stdio(3)
OBSERVACIONES¶
El comportamiento de
fgetwc 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
fgetwc lea realmente una secuencia multibyte del
flujo y que la convierta después en un carácter ancho.