Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fscanf — funkcja strumieniowa C23

`fscanf(stream, format, ...)` z `<stdio.h>` odczytuje ze strumienia znaki zgodnie z dyrektywami formatu i zapisuje wyniki przez kolejne argumenty wskaźnikowe. Zwraca liczbę wykonanych przypisań albo `EOF`, gdy błąd wejścia wystąpi przed pierwszą konwersją.

Wersja: C23

Składnia

int fscanf(FILE * restrict stream, const char * restrict format, ...);

fscanf(stream, format, ...) z <stdio.h> odczytuje ze strumienia znaki zgodnie z dyrektywami formatu i zapisuje wyniki przez kolejne argumenty wskaźnikowe. Zwraca liczbę wykonanych przypisań albo EOF, gdy błąd wejścia wystąpi przed pierwszą konwersją.

Przykład zapisuje 7 2.50 blue do pliku tymczasowego i skanuje go przez "%d %lf %4s" do int, double i pięcioelementowej tablicy char. Wynik 3 7 2.50 blue potwierdza trzy przypisania oraz ograniczenie szerokości napisu.

Błąd dopasowania przed pierwszym przypisaniem zwraca 0, a koniec pliku lub błąd odczytu przed konwersją zwraca EOF; %n nie zwiększa licznika. Typ każdego wskaźnika musi dokładnie odpowiadać konwersji. Dla %s i %[ podawaj szerokość nie większą niż pojemność minus jeden, inaczej możliwe są przepełnienie i niezdefiniowane zachowanie.

Przykłady

#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;}

Wynik

3 7 2.50 blue

Przykład zapisuje `7 2.50 blue` do pliku tymczasowego i skanuje go przez `"%d %lf %4s"` do `int`, `double` i pięcioelementowej tablicy `char`. Wynik `3 7 2.50 blue` potwierdza trzy przypisania oraz ograniczenie szerokości napisu.

Źródła