CKTIS / C
fsetpos — fonction de flux C23
`fsetpos(stream, pos)` de `<stdio.h>` restaure l’indicateur de position et, s’il existe, l’objet `mbstate_t` depuis une valeur enregistrée par un `fgetpos` réussi sur un flux associé au même fichier. Elle renvoie `0` au succès et une valeur non nulle à l’échec.
Version : C23
Syntaxe
int fsetpos(FILE *stream, const fpos_t *pos);fsetpos(stream, pos) de <stdio.h> restaure l’indicateur de position et, s’il existe, l’objet mbstate_t depuis une valeur enregistrée par un fgetpos réussi sur un flux associé au même fichier. Elle renvoie 0 au succès et une valeur non nulle à l’échec.
L’exemple écrit ABCDE, mémorise la position après AB, lit jusqu’à la fin et observe feof == 1. fsetpos restaure ensuite l’état ; 1 0 C montre que EOF est effacé et que C est relu à la position voulue.
Un succès annule les effets de ungetc, efface l’indicateur de fin et autorise ensuite lecture ou écriture sur un flux de mise à jour. fpos_t est opaque : pas d’arithmétique ni de transfert entre fichiers. En cas d’erreur de lecture ou écriture, l’indicateur d’erreur est posé ; la fonction renvoie une valeur non nulle et place dans errno une valeur positive dépendant de l’implémentation.
Exemples
#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;}
Résultat
1 0 C
L’exemple écrit `ABCDE`, mémorise la position après `AB`, lit jusqu’à la fin et observe `feof == 1`. `fsetpos` restaure ensuite l’état ; `1 0 C` montre que EOF est effacé et que `C` est relu à la position voulue.