KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen