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

Páginas de Manual de Linux 6.9.1                   2 Mayo 2024                                         fgetwc(3)