CKTIS / C
ungetc — devolver un carácter a un flujo
ungetc devuelve un carácter a un flujo para volver a leerlo, sin modificar el archivo. El código portable puede contar con espacio para un carácter.
Versión: C23; repository compiler flag, production runtime not attested
Sintaxis
#include <stdio.h>
int ungetc(int c, FILE *stream);ungetc, de <stdio.h>, devuelve c, convertido a unsigned char, al flujo de entrada stream. La siguiente lectura recupera ese carácter; no tiene por qué coincidir con uno leído anteriormente. El archivo permanece sin cambios.
La función devuelve el valor devuelto al flujo o EOF si falla. Pasar EOF provoca un fallo sin modificar el flujo. Guarda los resultados de fgetc en un int, no en un char.
Se garantiza un carácter; las devoluciones adicionales pueden fallar. Los caracteres se recuperan en orden inverso. Una llamada exitosa a ungetc borra el indicador de fin de archivo. Una llamada exitosa a fseek, fsetpos o rewind descarta los caracteres devueltos. Este mecanismo sirve para anticipar la lectura de la entrada, no para deshacer lecturas de forma general.
Ejemplos
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *stream = tmpfile();
if (stream == NULL)
return EXIT_FAILURE;
if (fputs("AB", stream) == EOF || fseek(stream, 0L, SEEK_SET) != 0) {
fclose(stream);
return EXIT_FAILURE;
}
if (fgetc(stream) != 'A' || ungetc('X', stream) == EOF) {
fclose(stream);
return EXIT_FAILURE;
}
int first = fgetc(stream);
int second = fgetc(stream);
int close_result = fclose(stream);
if (first != 'X' || second != 'B' || close_result == EOF)
return EXIT_FAILURE;
if (printf("%c %c\n", first, second) < 0)
return EXIT_FAILURE;
return EXIT_SUCCESS;
}Resultado
X B
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.