CKTIS / C
fseek — C23-Datenstromfunktion
`fseek(stream, offset, whence)` aus `<stdio.h>` setzt die Dateiposition relativ zu `SEEK_SET`, `SEEK_CUR` oder `SEEK_END`. Erfolg liefert `0`, Fehler einen Wert ungleich null; Erfolg löscht die Dateiendeanzeige und hebt Wirkungen von `ungetc` auf.
Version: C23
Syntax
int fseek(FILE *stream, long int offset, int whence);fseek(stream, offset, whence) aus <stdio.h> setzt die Dateiposition relativ zu SEEK_SET, SEEK_CUR oder SEEK_END. Erfolg liefert 0, Fehler einen Wert ungleich null; Erfolg löscht die Dateiendeanzeige und hebt Wirkungen von ungetc auf.
Das Beispiel schreibt ABCDE, springt zwei Bytes ab SEEK_SET und liest C. Danach liest es bis zum Ende, sieht feof == 1, springt zum Anfang und druckt C 1 0; damit ist das Löschen der EOF-Anzeige belegt.
Bei einem Binärstrom zählt der Offset Bytes, doch SEEK_END muss nicht unterstützt werden. Beim Textstrom sind nur Offset 0 oder ein früherer ftell-Wert mit SEEK_SET portabel. Nach Fehler kann die Position unbestimmt sein; nicht auf einem Strom ohne Positionierungsunterstützung suchen.
Beispiele
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("ABCDE",stream)==EOF||fseek(stream,2L,SEEK_SET)!=0){fclose(stream);return 1;}int selected=fgetc(stream);while(fgetc(stream)!=EOF){}int before=feof(stream)!=0;if(fseek(stream,0L,SEEK_SET)!=0){fclose(stream);return 1;}int after=feof(stream)!=0;printf("%c %d %d\n",selected,before,after);return fclose(stream)==0?0:1;}
Ergebnis
C 1 0
Das Beispiel schreibt `ABCDE`, springt zwei Bytes ab `SEEK_SET` und liest `C`. Danach liest es bis zum Ende, sieht `feof == 1`, springt zum Anfang und druckt `C 1 0`; damit ist das Löschen der EOF-Anzeige belegt.