WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

sscanf — formatierte Daten aus einer Zeichenkette lesen

sscanf aus <stdio.h> liest Daten gemäß einem Format aus einer nullterminierten Zeichenkette. Die Ergebnisse werden über Zeiger gespeichert; zurückgegeben wird die Anzahl erfolgreicher Zuweisungen (ohne `%n`), nicht die Zahl der gelesenen Zeichen.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <stdio.h>
int sscanf(const char * restrict s, const char * restrict format, ...);

sscanf funktioniert wie fscanf, liest aber eine Zeichenkette statt eines Datenstroms. Das Format beschreibt Konvertierungen und erforderliche wörtliche Zeichen. %d benötigt einen int *; verwende &age. Für das Array name übergib name selbst.

Prüfe den Rückgabewert, bevor du die Daten verwendest: Er zählt erfolgreiche Zuweisungen und kann kleiner als erwartet oder 0 sein. Die Direktive %n speichert die Anzahl der bisher gelesenen Zeichen, erhöht den Rückgabewert aber nicht. EOF bedeutet, dass ein Eingabefehler auftrat, bevor die erste Konvertierung abgeschlossen war. Erfolgreiche Zuweisungen garantieren nicht, dass die ganze Zeichenkette verbraucht wurde.

%s überspringt führende Leerraumzeichen, liest ein Wort und hängt ein Nullzeichen an. %7s benötigt mindestens 8 char-Elemente. Die meisten Konvertierungen überspringen führende Leerraumzeichen; %c, %[ und %n tun dies nicht.

Ein inkompatibler Zeigertyp, ein numerisches Ergebnis, das im Zielobjekt nicht darstellbar ist, oder das Kopieren zwischen überlappenden Objekten führt zu undefiniertem Verhalten. Die Feldbreite prüft nicht den Zahlenbereich. Im Beispiel werden beide Ergebnisse erst nach der Prüfung count == 2 verwendet.

Beispiele

#include <stdio.h>

int main(void)
{
    const char input[] = "Ada 42";
    char name[8];
    int age;
    int count = sscanf(input, "%7s %d", name, &age);

    if (count != 2) {
        puts("Parse failed");
        return 1;
    }

    printf("%s: %d\n", name, age);
    return 0;
}

Ergebnis

Ada: 42

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen