Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

rewind — návrat na začiatok súboru

rewind nastaví pozíciu prúdu na začiatok súboru a vymaže indikátor chyby. Nevracia žiadnu hodnotu, takže priamo neoznámi, či bolo nastavenie pozície úspešné.

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

Syntax

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

rewind(stream) z <stdio.h> nastaví otvorený prúd FILE na začiatok súboru. Odovzdajte platný ukazovateľ na otvorený prúd, nie NULL ani ukazovateľ použitý po fclose.

Funguje ako (void)fseek(stream, 0L, SEEK_SET), navyše však vymaže indikátor chyby. Úspešné nastavenie pozície vymaže aj indikátor konca súboru a zruší účinky ungetc. Obsah súboru nevymaže.

Vracia void. Ak treba zistiť neúspešné nastavenie pozície, použite fseek a skontrolujte jeho výsledok. Samotná kontrola ferror po volaní rewind úspech nepotvrdzuje. Nepredpokladajte, že každý prúd podporuje nastavovanie pozície.

Prí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ýsledok

first: A

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje