CKTIS / C
rewind — vrnitev na začetek datoteke
rewind nastavi položaj toka na začetek datoteke in počisti indikator napake. Ne vrne nobene vrednosti, zato ne more neposredno sporočiti, ali je bilo premikanje uspešno.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
void rewind(FILE *stream);rewind(stream) iz <stdio.h> nastavi odprti tok FILE na začetek datoteke. Podajte veljaven kazalec na odprti tok, ne NULL ali kazalca, ki ga uporabite po fclose.
Deluje kot (void)fseek(stream, 0L, SEEK_SET), vendar počisti tudi indikator napake. Uspešna nastavitev položaja počisti še indikator konca datoteke in odpravi učinke ungetc. Vsebine datoteke ne izbriše.
Vrne void. Če morate zaznati neuspešno nastavljanje položaja, uporabite fseek in preverite njegov rezultat. Samo preverjanje ferror po klicu rewind ne potrdi uspeha. Ne predpostavljajte, da vsak tok podpira nastavljanje položaja.
Primeri
#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;
}Rezultat
first: A
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.