fgetwc, getwc - leen un carácter ancho de un flujo FILE
Biblioteca Estándar C (
libc,
-lc)
#include <stdio.h>
#include <wchar.h>
wint_t fgetwc(FILE *flujo);
wint_t getwc(FILE *flujo);
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).
On success,
fgetwc() returns the next wide-character from the stream.
Otherwise,
WEOF is returned, and
errno is set to indicate the
error.
Aparte de los usuales, existe
- EILSEQ
- Los datos obtenidos del flujo de entrada no forman un
carácter ancho válido.
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 |
POSIX.1-2001, POSIX.1-2008, C99.
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.
fgetws(3),
fputwc(3),
ungetwc(3),
unlocked_stdio(3)
La traducción al español de esta página del manual fue
creada por Juan Piernas <
[email protected]>
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
[email protected]