CKTIS / C
SEEK_SET, SEEK_CUR, SEEK_END — Suchbezüge
Die Makros SEEK_SET, SEEK_CUR und SEEK_END wählen den Bezugspunkt für fseek: den Dateianfang, die aktuelle Position oder das Dateiende.
Version: 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 */Diese Makros aus <stdio.h> haben unterschiedliche ganzzahlige Werte; bestimmte Zahlenwerte dürfen nicht vorausgesetzt werden. Das Argument whence wählt den Bezugspunkt: SEEK_SET — Dateianfang, SEEK_CUR — aktuelle Position, SEEK_END — Dateiende.
Bei einem Binärstream addiert fseek offset zum Bezugspunkt; gezählt wird in C-Bytes. Die Unterstützung von SEEK_END ist selbst bei Binärstreams nicht garantiert. Bei einem Textstream muss offset null sein oder von einem früheren erfolgreichen ftell für dieselbe Datei stammen; im zweiten Fall ist SEEK_SET erforderlich.
Prüfe den Rückgabewert von fseek: Null bedeutet Erfolg, ein Wert ungleich null bedeutet einen Fehler.
Beispiele
#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;
}Ergebnis
B D
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.