Provided by:
manpages-es_1.55-8_all 
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.
CONFORME A
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.