Provided by: manpages-es_1.55-10_all bug

NOMBRE

       fgetwc, getwc - leen un caracter ancho de un flujo FILE

SINOPSIS

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

       wint_t fgetwc (FILE* stream);
       wint_t getwc (FILE* stream);

DESCRIPCI'ON

       La  funcion  fgetwc  es equivalente para caracteres anchos a la funcion
       fgetc. La funcion lee un caracter 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  conversion  de
       caracteres anchos, asigna a errno el valor EILSEQ y devuelve WEOF.

       La  funcion  o  macro  getwc funciona de la misma forma que fgetwc.  Se
       puede implementar como una macro y puede evaluar su  argumento  mas  de
       una vez. Nunca hay razon para usarla.

       Para las versiones no-bloqueantes, vease unlocked_stdio(3).

VALOR DEVUELTO

       La  funcion  fgetwc  devuelve  el  siguiente caracter ancho del flujo o
       WEOF.

ERRORES

       Aparte de los habituales, existe

       EILSEQ Los datos obtenidos del flujo de entrada no forman  un  caracter
              ancho valido.

CONFORME A

       ISO/ANSI C, UNIX98

V'EASE TAMBI'EN

       fputwc(3), fgetws(3), ungetwc(3), unlocked_stdio(3)

OBSERVACIONES

       El  comportamiento  de  fgetwc  depende  de la categoria LC_CTYPE de la
       localizacion actual.

       En ausencia de informacion adicional pasada  a  la  llamada  fopen,  es
       razonable  esperar que fgetwc lea realmente una secuencia multibyte del
       flujo y que la convierta despues en un caracter ancho.