Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

rewind — powrót na początek pliku

rewind ustawia pozycję strumienia na początku pliku i czyści wskaźnik błędu. Nie zwraca wyniku, więc nie pozwala bezpośrednio sprawdzić powodzenia operacji.

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

Składnia

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

rewind(stream) z <stdio.h> ustawia pozycję otwartego strumienia FILE na początku pliku. Przekaż poprawny wskaźnik do otwartego strumienia, nie NULL ani wskaźnik po fclose.

Działa jak (void)fseek(stream, 0L, SEEK_SET), ale dodatkowo czyści wskaźnik błędu. Udane przestawienie czyści też wskaźnik końca pliku i usuwa efekty ungetc. Nie kasuje zawartości pliku.

Zwraca void. Gdy trzeba wykrywać niepowodzenie pozycjonowania, użyj fseek i sprawdź wynik. Samo ferror po rewind nie potwierdza sukcesu. Nie zakładaj, że każdy strumień obsługuje pozycjonowanie.

Przykłady

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

Wynik

first: A

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

Źródła