WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen