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.

GNU                                               25 julio 1999                                        FGETWC(3)