Scroll to navigation

fgetwc(3) Library Functions Manual 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

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

POSIX.1-2001, POSIX.1-2008, 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.

15 Diciembre 2022 Páginas de manual de Linux 6.03