CKTIS / C
fseek — C23-streamfunctie
`fseek(stream, offset, whence)` uit `<stdio.h>` stelt de bestandspositie in ten opzichte van `SEEK_SET`, `SEEK_CUR` of `SEEK_END`. Het retourneert `0` bij succes en niet-nul bij een fout; succes wist de bestandseinde-indicator en maakt effecten van `ungetc` ongedaan.
Versie: C23
Syntax
int fseek(FILE *stream, long int offset, int whence);fseek(stream, offset, whence) uit <stdio.h> stelt de bestandspositie in ten opzichte van SEEK_SET, SEEK_CUR of SEEK_END. Het retourneert 0 bij succes en niet-nul bij een fout; succes wist de bestandseinde-indicator en maakt effecten van ungetc ongedaan.
Het voorbeeld schrijft ABCDE, zoekt twee bytes vanaf SEEK_SET en leest C. Daarna leest het tot het einde, ziet feof == 1, zoekt terug naar het begin en print C 1 0, waarmee het wissen van EOF wordt aangetoond.
Bij een binaire stream is de offset in bytes, maar SEEK_END hoeft niet ondersteund te zijn. Voor een tekststream zijn alleen offset 0 of een eerdere ftell-waarde met SEEK_SET overdraagbaar. Na een fout kan de positie onbepaald zijn; zoek niet in een stream zonder positionering.
Voorbeelden
#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;}
Resultaat
C 1 0
Het voorbeeld schrijft `ABCDE`, zoekt twee bytes vanaf `SEEK_SET` en leest `C`. Daarna leest het tot het einde, ziet `feof == 1`, zoekt terug naar het begin en print `C 1 0`, waarmee het wissen van EOF wordt aangetoond.