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.