Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes