CKTIS / C
SEEK_SET, SEEK_CUR, SEEK_END — zoekreferenties
De macro’s SEEK_SET, SEEK_CUR en SEEK_END kiezen het referentiepunt voor fseek: het begin, de huidige positie of het einde van het bestand.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdio.h>
int fseek(FILE *stream, long int offset, int whence);
/* whence: SEEK_SET, SEEK_CUR, SEEK_END */Deze macro’s uit <stdio.h> hebben verschillende gehele waarden; ga niet uit van bepaalde getallen. Het argument whence kiest het uitgangspunt: SEEK_SET — begin van het bestand, SEEK_CUR — huidige positie, SEEK_END — einde van het bestand.
Bij een binaire stream telt fseek offset op bij dat uitgangspunt, gemeten in C-bytes. Ondersteuning voor SEEK_END is zelfs bij binaire streams niet gegarandeerd. Bij een tekststream moet offset nul zijn of afkomstig zijn van een eerdere geslaagde ftell voor hetzelfde bestand; in dat laatste geval is SEEK_SET vereist.
Controleer het resultaat van fseek: nul betekent succes, een waarde ongelijk aan nul betekent een fout.
Voorbeelden
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
FILE *f = tmpfile();
int a, b;
if (f == NULL) return EXIT_FAILURE;
if (fputs("ABCDE", f) == EOF ||
fseek(f, 1L, SEEK_SET) != 0) {
fclose(f);
return EXIT_FAILURE;
}
a = fgetc(f);
if (a == EOF || fseek(f, 1L, SEEK_CUR) != 0) {
fclose(f);
return EXIT_FAILURE;
}
b = fgetc(f);
if (b == EOF || fclose(f) != 0) return EXIT_FAILURE;
if (printf("%c %c\n", a, b) < 0) return EXIT_FAILURE;
return EXIT_SUCCESS;
}Resultaat
B D
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.