vsscanf

Aus RAD Studio
Wechseln zu: Navigation, Suche

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++

+

+

+