vscanf, vwscanf

Nach oben zu stdio.h - Index

Header-Datei

stdio.h

Kategorie

Konsolen-Ein-/Ausgaberoutinen

Prototyp

int vscanf(const char *format, va_list arglist);

int vwscanf(const wchar_t *format, va_list arglist);

Beschreibung

Untersucht und formatiert Eingaben aus stdin.

Anmerkung:  Verwenden Sie diese Eigenschaft nicht in Win32-GUI-Anwendungen.

Die v...scanf-Funktionen können als alternative Eintrittspunkte für die ...scanf-Funktionen betrachtet werden. Sie verhalten sich genau wie ihre ...scanf-Entsprechungen, akzeptieren jedoch einen Zeiger auf eine Argumentliste statt der Argumentliste selbst.

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

vscanf untersucht Zeichen für Zeichen eine Reihe von Eingabefeldern, die aus stdin gelesen werden. Darauf wird jedes Feld entsprechend den Formatbezeichnern formatiert, die in dem im Parameter format an vscanf übergebenen Format-String enthalten sind. Schließlich speichert vscanf die formatierte Eingabe unter einer der Adressen, die ihr in dem Argument übergeben wurden, das auf das Argument format folgt. Die Anzahl der Formatbezeichner und Adressen muss der Anzahl der Eingabefelder entsprechen.

vscanf kann die Untersuchung eines bestimmten Feldes abbrechen, bevor das normale Feldendezeichen (Whitespace-Zeichen) erreicht ist, oder kann aus verschiedenen Gründen die gesamte Verarbeitung beenden. Eine Erläuterung der möglichen Gründe finden Sie unter scanf.

Rückgabewert

vscanf gibt die Anzahl erfolgreich untersuchter, konvertierter und gespeicherter Eingabefelder zurück. Die untersuchten Felder, die nicht gespeichert wurden, werden nicht gezählt. Wurden keine Felder gespeichert, ist der Rückgabewert 0.

Versucht vscanf, über das Dateiende hinaus zu lesen, wird EOF zurückgegeben.

Beispiel

 #include <stdio.h>
 #include <stdarg.h>
 int vscnf(char *fmt, ...)
 {
    va_list argptr;
    int cnt;
    printf("Enter an integer, a float, and a string (e.g. i,f,s,)\n");
    va_start(argptr, fmt);
    cnt = vscanf(fmt, argptr);
    va_end(argptr);
    return(cnt);
 }
 int main(void)
 {
    int inumber;
    float fnumber;
    char string[80];
    vscnf("%d, %f, %s", &inumber, &fnumber, string);
    printf("%d %f %s\n", inumber, fnumber, string);
    return 0;
 }

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+	+	+