CKTIS / C
fgetpos — C23-Datenstromfunktion
`fgetpos(stream, pos)` aus `<stdio.h>` speichert den aktuellen Positionszustand eines offenen Datenstroms im von `pos` bezeichneten `fpos_t`-Objekt. Es liefert null bei Erfolg und einen Wert ungleich null bei Fehler; der Zustand ist für späteres `fsetpos` bestimmt.
Version: C23
Syntax
int fgetpos(FILE * restrict stream, fpos_t * restrict pos);fgetpos(stream, pos) aus <stdio.h> speichert den aktuellen Positionszustand eines offenen Datenstroms im von pos bezeichneten fpos_t-Objekt. Es liefert null bei Erfolg und einen Wert ungleich null bei Fehler; der Zustand ist für späteres fsetpos bestimmt.
Das Beispiel schreibt ABC, liest A, sichert die Position mit fgetpos, liest B, stellt sie mit fsetpos wieder her und liest erneut B. 1 B B zeigt erfolgreiches Erfassen und Wiederherstellen des exakten Zustands.
fpos_t muss weder arithmetisch noch eine Bytezahl sein; es kann Mehrbyte-Analysezustand enthalten. Deshalb nicht rechnen oder als portablen Offset serialisieren. Beide Zeiger müssen gültig sein und pos bis zur Nutzung leben. Bei Fehler ist das Ergebnis ungleich null und die Implementierung speichert einen positiven Wert in errno.
Beispiele
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputs("ABC", stream) == EOF) { fclose(stream); return 1; }
rewind(stream);
if (fgetc(stream) != 'A') { fclose(stream); return 1; }
fpos_t position;
int saved = fgetpos(stream, &position) == 0;
int first = fgetc(stream);
if (!saved || fsetpos(stream, &position) != 0) { fclose(stream); return 1; }
int again = fgetc(stream);
printf("%d %c %c\n", saved, first, again);
return fclose(stream) == 0 ? 0 : 1;
}
Ergebnis
1 B B
Das Beispiel schreibt `ABC`, liest `A`, sichert die Position mit `fgetpos`, liest `B`, stellt sie mit `fsetpos` wieder her und liest erneut `B`. `1 B B` zeigt erfolgreiches Erfassen und Wiederherstellen des exakten Zustands.