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.

CONFORME A

       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.