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.