std:: ungetwc

Definido en el encabezado <cwchar>
std:: wint_t ungetwc ( std:: wint_t ch, std:: FILE * stream ) ;

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

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

Si std::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 llamadas exitosas a std::ungetwc , las operaciones de lectura recuperan los caracteres anchos retrocedidos en orden inverso al de std::ungetwc

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

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

Una llamada exitosa a std::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 devueltos sean recuperados con una operación de lectura, el indicador de posición del flujo es igual a su valor antes de std::ungetwc .

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.

Véase también

ungetc	coloca un carácter de vuelta en un flujo de archivo (función)
fgetwc getwc	obtiene un carácter ancho de un flujo de archivo (función)
Documentación C para ungetwc