CKTIS / C
fgetpos — fonction de flux C23
`fgetpos(stream, pos)` de `<stdio.h>` stocke l’état de position courant d’un flux ouvert dans l’objet `fpos_t` désigné par `pos`. Elle renvoie zéro en cas de succès et une valeur non nulle en cas d’échec ; l’état sert à un futur `fsetpos`.
Version : C23
Syntaxe
int fgetpos(FILE * restrict stream, fpos_t * restrict pos);fgetpos(stream, pos) de <stdio.h> stocke l’état de position courant d’un flux ouvert dans l’objet fpos_t désigné par pos. Elle renvoie zéro en cas de succès et une valeur non nulle en cas d’échec ; l’état sert à un futur fsetpos.
L’exemple écrit ABC, lit A, sauvegarde avec fgetpos, lit B, restaure avec fsetpos puis relit B. 1 B B montre la capture et la restauration exactes de l’état.
fpos_t n’est pas forcément arithmétique ni un nombre d’octets ; il peut inclure l’état d’analyse multioctet. Ne faites donc pas d’arithmétique dessus et ne le sérialisez pas comme offset portable. Les deux pointeurs doivent être valides et pos rester vivant. En cas d’échec, le retour est non nul et l’implémentation stocke une valeur positive dans errno.
Exemples
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputs("ABC", stream) == EOF) { fclose(stream); return 1; }
rewind(stream);
if (fgetc(stream) != 'A') { fclose(stream); return 1; }
fpos_t position;
int saved = fgetpos(stream, &position) == 0;
int first = fgetc(stream);
if (!saved || fsetpos(stream, &position) != 0) { fclose(stream); return 1; }
int again = fgetc(stream);
printf("%d %c %c\n", saved, first, again);
return fclose(stream) == 0 ? 0 : 1;
}
Résultat
1 B B
L’exemple écrit `ABC`, lit `A`, sauvegarde avec `fgetpos`, lit `B`, restaure avec `fsetpos` puis relit `B`. `1 B B` montre la capture et la restauration exactes de l’état.