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

CKTIS / C

rewind — връщане в началото на файл

rewind позиционира потока в началото на файла и изчиства индикатора му за грешка. Функцията не връща стойност, затова не може пряко да покаже дали преместването е успешно.

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

Синтаксис

#include <stdio.h>
void rewind(FILE *stream);

rewind(stream) от <stdio.h> позиционира отворен поток FILE в началото на файла. Подайте валиден указател към отворен поток, а не NULL или указател, използван след fclose.

Функцията действа като (void)fseek(stream, 0L, SEEK_SET), но изчиства и индикатора за грешка. Успешното позициониране изчиства също индикатора за край на файла и отменя ефектите на ungetc. Съдържанието на файла не се изтрива.

Функцията връща void. Когато трябва да се откриват неуспешни операции за позициониране, използвайте fseek и проверете резултата. Само проверка на ferror след rewind не потвърждава успех. Не приемайте, че всеки поток поддържа позициониране.

Примери

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE *stream = tmpfile();
    if (stream == NULL) {
        return EXIT_FAILURE;
    }
    if (fputs("ABC", stream) == EOF || fflush(stream) == EOF) {
        fclose(stream);
        return EXIT_FAILURE;
    }

    rewind(stream);
    int first = fgetc(stream);
    if (first != 'A') {
        fclose(stream);
        return EXIT_FAILURE;
    }

    if (fclose(stream) == EOF) {
        return EXIT_FAILURE;
    }
    if (printf("first: %c\n", first) < 0) {
        return EXIT_FAILURE;
    }
    return EXIT_SUCCESS;
}

Резултат

first: A

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

Източници