Namespaces
Variants

ungetwc

From cppreference.net
< c ‎ | io
Definido en el encabezado <wchar.h>
wint_t ungetwc ( wint_t ch, FILE * stream ) ;
(desde C95)

Si ch no es igual a WEOF , introduce el carácter ancho ch en el búfer de entrada asociado al flujo stream de tal manera que las operaciones de lectura posteriores desde stream recuperarán ese carácter ancho. El dispositivo externo asociado al flujo no se modifica.

Operaciones de reposicionamiento de flujo fseek , fsetpos , y rewind descartan los efectos de ungetwc .

Si ungetwc se llama más de una vez sin una lectura o reposicionamiento intermedio, puede fallar (en otras palabras, se garantiza un búfer de retroceso de tamaño 1, pero cualquier búfer más grande está definido por la implementación). Si se realizan múltiples ungetwc exitosos, las operaciones de lectura recuperan los caracteres anchos retrocedidos en orden inverso al de ungetwc

Si ch es igual a WEOF , la operación falla y el flujo no se ve afectado.

Una llamada exitosa a ungetwc limpia el indicador de estado de fin de archivo feof .

Una llamada exitosa a ungetwc en un flujo (ya sea de texto o binario) modifica el indicador de posición del flujo de manera no especificada, pero garantiza que después de que todos los caracteres anchos retrocedidos sean recuperados con una operación de lectura, el indicador de posición del flujo es igual a su valor antes de ungetwc .

Contenidos

Parámetros

ch - carácter ancho a devolver
stream - flujo de archivo al que devolver el carácter ancho

Valor de retorno

En caso de éxito ch es devuelto.

En caso de fallo WEOF es retornado y el flujo dado permanece sin cambios.

Referencias

  • Estándar C11 (ISO/IEC 9899:2011):
  • 7.29.3.10 La función ungetwc (p: 425-426)
  • Estándar C99 (ISO/IEC 9899:1999):
  • 7.24.3.10 La función ungetwc (p: 370-371)

Véase también

coloca un carácter de vuelta en un flujo de archivo
(función)
obtiene un carácter ancho de un flujo de archivo
(función)