Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes