CKTIS / C
fscanf — C23-Datenstromfunktion
`fscanf(stream, format, ...)` aus `<stdio.h>` liest Zeichen nach Formatdirektiven aus einem Strom und speichert Ergebnisse über aufeinanderfolgende Zeigerargumente. Rückgabewert ist die Zahl ausgeführter Zuweisungen oder `EOF`, falls vor der ersten Konvertierung ein Eingabefehler eintritt.
Version: C23
Syntax
int fscanf(FILE * restrict stream, const char * restrict format, ...);fscanf(stream, format, ...) aus <stdio.h> liest Zeichen nach Formatdirektiven aus einem Strom und speichert Ergebnisse über aufeinanderfolgende Zeigerargumente. Rückgabewert ist die Zahl ausgeführter Zuweisungen oder EOF, falls vor der ersten Konvertierung ein Eingabefehler eintritt.
Das Beispiel schreibt 7 2.50 blue in eine temporäre Datei und liest mit "%d %lf %4s" in int, double und ein char-Array mit fünf Elementen. 3 7 2.50 blue bestätigt drei Zuweisungen und die begrenzte Zeichenkette.
Ein Anpassungsfehler vor jeder Zuweisung liefert 0, Dateiende oder Lesefehler vor der Konvertierung dagegen EOF; %n zählt nicht mit. Jeder Zeigertyp muss exakt zur Konvertierung passen. Für %s und %[ eine Breite höchstens Kapazität minus eins angeben, sonst drohen Überlauf und undefiniertes Verhalten.
Beispiele
#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;}
Ergebnis
3 7 2.50 blue
Das Beispiel schreibt `7 2.50 blue` in eine temporäre Datei und liest mit `"%d %lf %4s"` in `int`, `double` und ein `char`-Array mit fünf Elementen. `3 7 2.50 blue` bestätigt drei Zuweisungen und die begrenzte Zeichenkette.