ungetwc
| Types and objects | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
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) |
|
|
(C95)
|
obtiene un carácter ancho de un flujo de archivo
(función) |
|
Documentación de C++
para
ungetwc
|
|