CKTIS / C
fsetpos — C23-Datenstromfunktion
`fsetpos(stream, pos)` aus `<stdio.h>` stellt Dateipositionsanzeiger und gegebenenfalls das `mbstate_t`-Objekt aus einem Wert wieder her, den ein erfolgreiches `fgetpos` für einen mit derselben Datei verbundenen Strom gespeichert hat. Erfolg liefert `0`, Fehler einen Wert ungleich null.
Version: C23
Syntax
int fsetpos(FILE *stream, const fpos_t *pos);fsetpos(stream, pos) aus <stdio.h> stellt Dateipositionsanzeiger und gegebenenfalls das mbstate_t-Objekt aus einem Wert wieder her, den ein erfolgreiches fgetpos für einen mit derselben Datei verbundenen Strom gespeichert hat. Erfolg liefert 0, Fehler einen Wert ungleich null.
Das Beispiel schreibt ABCDE, speichert die Position nach AB, liest bis zum Ende und sieht feof == 1. Danach stellt fsetpos den Zustand wieder her; 1 0 C zeigt die gelöschte EOF-Anzeige und das erneute Lesen von C an der richtigen Stelle.
Erfolg hebt Wirkungen von ungetc auf, löscht die Dateiendeanzeige und erlaubt bei einem Aktualisierungsstrom als Nächstes Eingabe oder Ausgabe. fpos_t ist undurchsichtig: keine Arithmetik und kein Übertragen zwischen Dateien. Bei Lese- oder Schreibfehler wird der Fehleranzeiger gesetzt; Rückgabe ist ungleich null und errno erhält einen positiven implementierungsabhängigen Wert.
Beispiele
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF){fclose(stream);return 1;}rewind(stream);if(fgetc(stream)!='A'||fgetc(stream)!='B'){fclose(stream);return 1;}fpos_t pos;if(fgetpos(stream,&pos)!=0){fclose(stream);return 1;}while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fsetpos(stream,&pos)!=0){fclose(stream);return 1;}int after=feof(stream)!=0,character=fgetc(stream);printf("%d %d %c\n",before,after,character);return fclose(stream)==0?0:1;}
Ergebnis
1 0 C
Das Beispiel schreibt `ABCDE`, speichert die Position nach `AB`, liest bis zum Ende und sieht `feof == 1`. Danach stellt `fsetpos` den Zustand wieder her; `1 0 C` zeigt die gelöschte EOF-Anzeige und das erneute Lesen von `C` an der richtigen Stelle.