Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

sscanf — leggere dati formattati da una stringa

sscanf di <stdio.h> legge dati da una stringa terminata da un carattere nullo secondo un formato. Memorizza i risultati tramite puntatori e restituisce il numero di assegnazioni riuscite (esclusa quella di `%n`), non il numero di caratteri letti.

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

Sintassi

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

sscanf funziona come fscanf, ma legge una stringa invece di un flusso. Il formato descrive le conversioni e i caratteri letterali richiesti. %d richiede un int *; usa &age. Per l’array name, passa direttamente name.

Controlla il valore restituito prima di usare i dati: conta le assegnazioni riuscite e può essere inferiore a quanto previsto o pari a 0. La direttiva %n memorizza il numero di caratteri letti fino a quel momento, ma non incrementa il valore restituito. EOF indica un errore di input prima che la prima conversione sia completata. Le assegnazioni riuscite non garantiscono che l’intera stringa sia stata consumata.

%s ignora gli spazi bianchi iniziali, legge una parola e aggiunge un carattere nullo. %7s richiede almeno 8 elementi char. La maggior parte delle conversioni ignora gli spazi bianchi iniziali; %c, %[ e %n non lo fanno.

Un tipo di puntatore incompatibile, un risultato numerico non rappresentabile nell’oggetto di destinazione o una copia tra oggetti sovrapposti causa un comportamento indefinito. La larghezza di campo non controlla l’intervallo numerico. Nell’esempio, entrambi i risultati vengono usati solo dopo aver verificato count == 2.

Esempi

#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;
}

Risultato

Ada: 42

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti