CKTIS / C
rewind — povratak na početak datoteke
rewind postavlja položaj toka na početak datoteke i briše indikator pogreške. Ne vraća nikakvu vrijednost pa ne može izravno javiti je li premještanje položaja uspjelo.
Verzija: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdio.h>
void rewind(FILE *stream);rewind(stream) iz <stdio.h> postavlja otvoreni tok FILE na početak datoteke. Proslijedite valjan pokazivač na otvoreni tok, a ne NULL ni pokazivač koji se koristi nakon fclose.
Djeluje kao (void)fseek(stream, 0L, SEEK_SET), ali uz to briše indikator pogreške. Uspješno premještanje položaja briše i indikator kraja datoteke te poništava učinke funkcije ungetc. Ne briše sadržaj datoteke.
Vraća void. Ako treba otkriti neuspješno postavljanje položaja, upotrijebite fseek i provjerite njegov rezultat. Samo provjeravanje funkcije ferror nakon rewind ne potvrđuje uspjeh. Nemojte pretpostaviti da svaki tok podržava postavljanje položaja.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.