Provided by: manpages-es_1.55-3_all bug

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.