CKTIS / C
fscanf — função de fluxo C23
`fscanf(stream, format, ...)` de `<stdio.h>` lê caracteres de um fluxo segundo diretivas de formato e guarda conversões através dos argumentos ponteiro sucessivos. Devolve o número de atribuições efetuadas, ou `EOF` quando uma falha de entrada antecede a primeira conversão.
Versão: C23
Sintaxe
int fscanf(FILE * restrict stream, const char * restrict format, ...);fscanf(stream, format, ...) de <stdio.h> lê caracteres de um fluxo segundo diretivas de formato e guarda conversões através dos argumentos ponteiro sucessivos. Devolve o número de atribuições efetuadas, ou EOF quando uma falha de entrada antecede a primeira conversão.
O exemplo escreve 7 2.50 blue num ficheiro temporário e lê com "%d %lf %4s" para um int, um double e um array de cinco char. 3 7 2.50 blue confirma três atribuições e a conversão limitada da cadeia.
Falha de correspondência antes de atribuir devolve 0; fim de ficheiro ou erro de leitura antes de converter devolve EOF; %n não aumenta a contagem. Cada tipo de ponteiro tem de corresponder exatamente. Para %s e %[ usa largura até capacidade menos um, senão podem ocorrer overflow e comportamento indefinido.
Exemplos
#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;}
Resultado
3 7 2.50 blue
O exemplo escreve `7 2.50 blue` num ficheiro temporário e lê com `"%d %lf %4s"` para um `int`, um `double` e um array de cinco `char`. `3 7 2.50 blue` confirma três atribuições e a conversão limitada da cadeia.