vsscanf
Nach oben zu stdio.h - Index
Header-Datei
stdio.h
Kategorie
Routinen für Speicher- und String-Bearbeitung
Prototyp
int vsscanf(const char *buffer, const char *format, va_list arglist);
int vswscanf(const wchar_t *buffer, const wchar_t *format, va_list arglist);
Beschreibung
Untersucht und formatiert Eingaben aus einem Stream.
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.
vsscanf untersucht Zeichen für Zeichen eine Reihe von Eingabefeldern, die aus einem Stream gelesen werden. Darauf wird jedes Feld entsprechend den Formatbezeichnern formatiert, die in dem im Parameter format an vsscanf übergebenen Format-String enthalten sind. Schließlich speichert vsscanf 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.
vsscanf kann die Untersuchung eines bestimmten Feldes abbrechen, bevor das normale Feldendezeichen (Whitespace-Zeichen) erreicht wird, oder kann aus verschiedenen Gründen die gesamte Verarbeitung beenden. Eine Erläuterung der möglichen Gründe finden Sie unter scanf.
Rückgabewert
vsscanf 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 vsscanf, über das Dateiende hinaus zu lesen, wird EOF zurückgegeben.
Beispiel
#include <stdio.h>
#include <stdarg.h>
char buffer[80] = "30 90.0 abc";
int vssf(char *fmt, ...)
{
va_list argptr;
int cnt;
fflush(stdin);
va_start(argptr, fmt);
cnt = vsscanf(buffer, fmt, argptr);
va_end(argptr);
return(cnt);
}
int main(void)
{
int inumber;
float fnumber;
char string[80];
vssf("%d %f %s", &inumber, &fnumber, string);
printf("%d %f %s\n", inumber, fnumber, string);
return 0;
}
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ |
---|---|---|---|
+ |
+ |
+ |