NOMBRE¶
ungetwc - vuelve a colocar un carácter ancho en un flujo FILE
SINOPSIS¶
#include <wchar.h>
wint_t ungetwc (wint_t wc, FILE *stream);
DESCRIPCION¶
La función
ungetwc es equivalente para caracteres anchos a la
función
ungetc. Esta función vuelve a colocar un
carácter ancho en el flujo
stream, devolviendo dicho
carácter.
Si
wc es WEOF, devuelve WEOF. Si
wc es un carácter ancho
inválido, asigna a
errno el valor
EILSEQ y devuelve WEOF.
Si
wc es un carácter ancho válido, se reinserta en el flujo y,
por tanto, estará disponible para futuras operaciones de lectura de
caracteres anchos. El indicador de posición del fichero se reduce en uno
o más. El indicador de fin-de-fichero se limpia. El almacenamiento de
respaldo del fichero no se ve afectado.
Nota: no es necesario que
wc sea el último carácter ancho
leído del flujo. Puede ser cualquier otro carácter ancho
válido.
Si la implementación soporta múltiples operaciones de
reinserción, los caracteres anchos reinsertados se leerán en orden
inverso. No obstante, sólo se garantiza un nivel de reinserción.
VALOR DEVUELTO¶
La función
ungetwc devuelve
wc en caso de éxito, o WEOF
en caso de fallo.
ISO/ANSI C, UNIX98
VÉASE TAMBIÉN¶
fgetwc(3)
OBSERVACIONES¶
El comportamiento de
ungetwc depende de la categoría LC_CTYPE de la
localización actual.