fgetwc(3)

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).
Interfaz | Atributo | Valor
fgetwc(), getwc() | Seguridad del hilo | Multi-hilo seguro

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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.