База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

ungetc — връщане на знак в поток

ungetc връща знак в поток, за да бъде прочетен отново, без да променя файла. Преносимият код може да разчита на място за един знак.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

ungetc от <stdio.h> връща c, преобразуван в unsigned char, във входния поток stream. При следващото четене този знак се извлича; не е задължително да съвпада със знак, прочетен по-рано. Файлът остава непроменен.

Функцията връща върнатата стойност или EOF при неуспех. Подаването на EOF води до неуспех, без да променя потока. Записвайте резултатите от fgetc в int, а не в char.

Гарантирано е място за един знак; следващите връщания може да не успеят. Знаците се извличат в обратен ред. Успешното извикване на ungetc изчиства индикатора за край на файл. Успешното извикване на fseek, fsetpos или rewind отхвърля върнатите знаци. Този механизъм служи за предварителен преглед на входа, а не за общо връщане назад при четене.

Примери

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

Резултат

X B

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници