NOMBRE¶

fgetwc, getwc - leen un carácter ancho de un flujo FILE

BIBLIOTECA¶

Biblioteca Estándar C (libc, -lc)

SINOPSIS¶

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

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

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 flujo y lo devuelve como resultado. Si se llega al final del flujo o si ferror(flujo) 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¶

On success, fgetwc() returns the next wide-character from the stream. Otherwise, WEOF is returned, and errno is set to indicate the error.

ERRORES¶

Aparte de los usuales, existe

EILSEQ

Los datos obtenidos del flujo de entrada no forman un carácter ancho válido.

ATRIBUTOS¶

Para obtener una explicación de los términos usados en esta sección, véase attributes(7).

ESTÁNDARES¶

C11, POSIX.1-2008.

HISTORIAL¶

POSIX.1-2001, C99.

NOTAS¶

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.

VÉASE TAMBIÉN¶

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

TRADUCCIÓN¶

La traducción al español de esta página del manual fue creada por Juan Piernas <piernas@ditec.um.es>

Esta traducción es documentación libre; lea la GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD.

Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org.