Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

ungetc — odkładanie znaku do strumienia

ungetc odkłada znak do ponownego odczytu ze strumienia wejściowego, nie zmieniając pliku. Przenośnie zagwarantowane jest miejsce na jeden znak.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <stdio.h>
int ungetc(int c, FILE *stream);

ungetc z <stdio.h> odkłada c, po konwersji do unsigned char, do strumienia wejściowego stream. Następny odczyt pobiera odłożony znak; nie musi on odpowiadać wcześniej odczytanemu. Plik pozostaje niezmieniony.

Funkcja zwraca odłożoną wartość albo EOF przy niepowodzeniu. Argument EOF powoduje niepowodzenie bez zmiany strumienia. Wynik fgetc przechowuj w int, nie char.

Zagwarantowany jest jeden znak; kolejne odłożenia mogą zawieść. Znaki wracają w odwrotnej kolejności. Udane ungetc usuwa znacznik końca pliku. Udane fseek, fsetpos lub rewind odrzuca odłożone znaki. To mechanizm podglądu wejścia, nie ogólnego cofania odczytu.

Przykłady

#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;
}

Wynik

X B

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła