CKTIS / C
fscanf — fonction de flux C23
`fscanf(stream, format, ...)` de `<stdio.h>` lit les caractères d’un flux selon les directives de format et stocke les conversions via les arguments pointeurs successifs. Elle renvoie le nombre d’affectations réalisées, ou `EOF` si une défaillance d’entrée précède la première conversion.
Version : C23
Syntaxe
int fscanf(FILE * restrict stream, const char * restrict format, ...);fscanf(stream, format, ...) de <stdio.h> lit les caractères d’un flux selon les directives de format et stocke les conversions via les arguments pointeurs successifs. Elle renvoie le nombre d’affectations réalisées, ou EOF si une défaillance d’entrée précède la première conversion.
L’exemple écrit 7 2.50 blue dans un fichier temporaire puis le lit avec "%d %lf %4s" dans un int, un double et un tableau de cinq char. 3 7 2.50 blue confirme trois affectations et la conversion de chaîne bornée.
Un échec de correspondance avant toute affectation renvoie 0, tandis qu’une fin de fichier ou erreur de lecture avant conversion renvoie EOF ; %n n’augmente pas le compte. Chaque type de pointeur doit correspondre exactement. Pour %s et %[, limitez la largeur à capacité moins un, sinon débordement et comportement indéfini sont possibles.
Exemples
#include <stdio.h>
int main(void){FILE *stream=tmpfile();if(!stream)return 1;if(fputs("7 2.50 blue",stream)==EOF){fclose(stream);return 1;}rewind(stream);int count=0,number=0;double price=0.0;char color[5]={0};count=fscanf(stream,"%d %lf %4s",&number,&price,color);printf("%d %d %.2f %s\n",count,number,price,color);return fclose(stream)==0?0:1;}
Résultat
3 7 2.50 blue
L’exemple écrit `7 2.50 blue` dans un fichier temporaire puis le lit avec `"%d %lf %4s"` dans un `int`, un `double` et un tableau de cinq `char`. `3 7 2.50 blue` confirme trois affectations et la conversion de chaîne bornée.