NOMBRE

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

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

       The  fgetwc()   function returns the next wide-character from the stream, or WEOF.  In the
       event of an error, errno is set to indicate the cause.

ERRORES

       Aparte de los habituales, 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 │
       └──────────────────┴────────────────────┴───────────────────┘

CONFORME A

       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)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar  una
       descripción  del  proyecto, información sobre cómo informar errores y la última versión de
       esta página en https://www.kernel.org/doc/man-pages/.

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