oracular (3) fgetwc.3.gz

Provided by: manpages-es-dev_4.23.1-1_all bug

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

       ┌───────────────────────────────────────────────────────────────┬────────────────────┬───────────────────┐
       │InterfazAtributoValor             │
       ├───────────────────────────────────────────────────────────────┼────────────────────┼───────────────────┤
       │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⟩.