Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

fseek — fonction de flux C23

`fseek(stream, offset, whence)` de `<stdio.h>` fixe la position du fichier par rapport à `SEEK_SET`, `SEEK_CUR` ou `SEEK_END`. Elle renvoie `0` au succès et une valeur non nulle à l’échec ; le succès efface l’indicateur de fin et annule les effets de `ungetc`.

Version : C23

Syntaxe

int fseek(FILE *stream, long int offset, int whence);

fseek(stream, offset, whence) de <stdio.h> fixe la position du fichier par rapport à SEEK_SET, SEEK_CUR ou SEEK_END. Elle renvoie 0 au succès et une valeur non nulle à l’échec ; le succès efface l’indicateur de fin et annule les effets de ungetc.

L’exemple écrit ABCDE, se place deux octets après SEEK_SET et lit C. Il atteint ensuite la fin, observe feof == 1, revient au début et affiche C 1 0, démontrant que le positionnement réussi efface EOF.

Dans un flux binaire, le déplacement se mesure en octets, mais SEEK_END peut ne pas être pris en charge. Pour un flux texte, seuls zéro ou une valeur antérieure de ftell avec SEEK_SET sont portables. Après échec, la position peut être indéterminée ; ne positionnez pas un flux qui ne le permet pas.

Exemples

#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;}

Résultat

C 1 0

L’exemple écrit `ABCDE`, se place deux octets après `SEEK_SET` et lit `C`. Il atteint ensuite la fin, observe `feof == 1`, revient au début et affiche `C 1 0`, démontrant que le positionnement réussi efface EOF.

Sources