fscanf_s, fwscanf_s

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu stdio.h - Index


Header-Datei

stdio.h

Kategorie

Funktionen für die formatierte Eingabe/Ausgabe

Prototyp

int fscanf_s(FILE * restrict stream, const char * restrict format, [, address, ...]);

int fwscanf_s(FILE * restrict stream, const wchar_t * restrict format, [, address, ...]);

Beschreibung

Ersetzt fscanf, fwscanf und fügt Sicherheitserweiterungen hinzu.

fscanf_s untersucht Zeichen für Zeichen eine Reihe von Eingabefeldern, die aus einem durch stream bezeichneten dtream gelesen werden. Danach wird jedes Feld entsprechend den Formatbezeichnern formatiert, die in dem im Parameter format an fscanf übergebenen Format-String enthalten sind. Schließlich speichert fscanf die formatierte Eingabe unter einer der Adressen, die in dem auf format folgenden Argument übergeben wurden. Die Anzahl der Formatbezeichner und Adressen muss der Anzahl der Eingabefelder entsprechen.

Hinweis: Einzelheiten zu den Formatbezeichnern finden Sie unter scanf-Formatbezeichner.

Rückgabewert

fscanf_s gibt die Anzahl erfolgreich untersuchter, konvertierter und gespeicherter Eingabefelder zurück. Dieser Wert kann Null sein, wenn beim ersten Feld ein Zuordnungsfehler auftrat.

Wenn vor einer Konvertierung ein Fehler auftritt, ist der Rückgabewert das Makro EOF.

Beispiel

#include <stdlib.h> 
#include <stdio.h> 
int main(void) 
{ 
   int i; 
   printf("Input an integer: "); 
   /* Read an integer from the 
      standard input stream */ 
   if (fscanf_s(stdin, "%d", &i))  
      printf("The integer read was: %i\n", i);
   else 
   { 
      fprintf(stderr, "Error reading an integer from stdin.\n"); 
      exit(1); 
   } return 0;
}

Portabilität

POSIX Win32 ANSI C ANSI C++

+

+

+

+

Siehe auch