Manual del Programador de Linux (3)
25 julio 1999
 

NOMBRE

fgetwc - lee 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.  

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)  

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.

Nuevo comentario