Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

rewind — návrat na začátek souboru

rewind nastaví pozici proudu na začátek souboru a vymaže indikátor chyby. Nevrací žádnou hodnotu, takže přímo neoznámí, zda bylo nové nastavení pozice úspěšné.

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

Syntaxe

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

rewind(stream) z <stdio.h> nastaví otevřený proud FILE na začátek souboru. Předejte platný ukazatel na otevřený proud, nikoli NULL ani ukazatel použitý po fclose.

Funguje jako (void)fseek(stream, 0L, SEEK_SET), navíc však vymaže indikátor chyby. Úspěšné nastavení pozice také vymaže indikátor konce souboru a zruší účinky ungetc. Obsah souboru nevymaže.

Vrací void. Pokud je třeba zjistit neúspěšné nastavení pozice, použijte fseek a zkontrolujte jeho výsledek. Pouhá kontrola ferror po volání rewind úspěch nepotvrzuje. Nepředpokládejte, že každý proud podporuje nastavování pozice.

Příklady

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

Výsledek

first: A

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje