Questa voce sull'argomento programmazione è solo un abbozzo.

Contribuisci a migliorarla secondo le convenzioni di Teknopedia.

scanf (abbreviazione dell'inglese scan formatted) è una funzione che viene implementata in diversi linguaggi di programmazione. Viene utilizzata per l'inserimento di dati formattati (caratteri e numeri). Da essa derivano inoltre altre funzioni, tra le cui più citate fscanf e sscanf.

Ha origine dal linguaggio C dove è inclusa nella libreria stdio.h, ma queste funzioni sono precedenti a C^[1] e possiedono altri nomi, come ad esempio readf in ALGOL 68.

La funzione è stata implementata da Mike Lesk^[2], assieme al resto della libreria cui appartiene, la quale è stata poi ufficialmente resa parte di Unix dalla versione 7 (1979).

La funzione ha il seguente prototipo:

int scanf(const char *format, ...);

Dal C99 e a seguire è stato introdotto restrict^[3] con i definitori (vedi anche restrict):

int scanf(const char * restrict format, ...);

La funzione legge dei caratteri dal canale standard di input (stdin^[4]), solitamente la tastiera, li converte secondo le specifiche di formattazione fornite dall'argomento format e memorizza i valori ottenuti negli argomenti seguenti in concordanza del tipo di dato richiesto.^[5] La funzione si ferma quando esaurisce la propria stringa di formattazione o quando alcuni dati in ingresso non soddisfano le specifiche di conversione. Il valore restituito è un numero intero che indica quanti valori sono stati estratti correttamente: negativo se si è verificato un errore, positivo se c'è stata una lettura e in particolare 0 (zero) se non è stata fatta alcuna assegnazione perché il primo carattere letto non è conforme alla prima specifica della stringa di formato.

Similarmente alla funzione printf, il ... sta ad indicare che si tratti di una funzione variadica (che può assumere un numero variabile di parametri).

scanf (tipo, &arg);

#include <stdio.h>   
/* Libreria standard per l'I/O */

int main() {
    int n;
    printf("Inserisci il valore di N: ");
    scanf("%d", &n);
    printf("N al quadrato è uguale a %d\n", n*n);
    return 0;    
}

%[*][ampiezza][{h|l|L}]tipo

La funzione scanf() restituisce il numero (int) di campi che sono stati convertiti e assegnati correttamente. Il valore di ritorno non comprende il numero di campi che sono stati letti, ma non assegnati.

Il valore di ritorno è negativo, EOF (end of file), per un tentativo di lettura alla fine del file, se non è stata eseguita alcuna conversione. Un valore di ritorno 0 (zero) indica che non sono stati assegnati campi.^[11]

Se il tipo di argomento a cui deve essere assegnato è diverso dalla specifica di formato, possono verificarsi risultati imprevedibili. Ad esempio, la lettura di un valore a virgola mobile, ma l'assegnazione in una variabile di tipo int, non è corretta e avrebbe risultati imprevedibili.

Se ci sono più argomenti che specifiche di formato, gli argomenti supplementari vengono ignorati. I risultati non sono definiti se non vi sono argomenti sufficienti per le specifiche di formato.

Se la stringa di formato contiene una specifica di formato non valida e vengono utilizzate specifiche di formato posizionali, errno verrà impostato su EILSEQ.

Se vengono utilizzate specifiche di formato posizionale e non vi sono argomenti sufficienti, errno verrà impostato su EINVAL.

Se si verifica un errore di conversione, errno può essere impostato su ECONVERT.^[12]

#include <stdio.h>
int main(void) 
{ 
    int i; 
    float fp; 
    char c, s[81]; 
    printf("Inserire un numero intero, un numero reale," 
            " un carattere e una stringa: \n"); 
    if (scanf("%d %f %c %s", &i, &fp, &c, s) != 4) 
        printf("Non tutti i campi sono stati compilati\n"); 
    else 
    { 
        printf("numero intero = %d\n", i); 
        printf("numero reale = %f\n", fp); 
        printf("carattere = %c\n", c); 
        printf("stringa = %s\n",s); 
    } 
}

Se l'input è 27 5.4 t si, allora l'uotput sarà simile a:

Inserire un numero intero, un numero reale, un carattere e una stringa:
numero intero = 27
numero reale = 5.400000
carattere = t
stringa = si

#include <stdio.h>
int main()
{
    int i;
    float x, y;
    char name[50];
    printf ("Inserire due stringhe numeriche che contengano 8 caratteri"
            " ognuna e che abbiano entrambe un punto al centro:\n");
    scanf("%2d %f %6f %[0123456789]", &i, &x, &y, name);
    printf("numero intero = %d\n", i);
    printf("primo numero reale = %f\n", x);
    printf("secondo numero reale = %f\n", y);
    printf("il resto della stringa = %s\n",name);
}

Inserire due stringhe numeriche che contengano almeno 8 caratteri ognuna e che abbiano entrambe un punto al centro:
numero intero = 12
primo numero reale = 34.432098
secondo numero reale = 1234.400024
resto della stringa = 321

#include <stdio.h>
int main()
{
   int numero;
   printf("Inserire un numero esadecimale o qualunque altra cosa diversa per uscire:\n");
   while (scanf("%x",&numero))
   {
      printf("Numero esadecimale = %x\n",numero);
      printf("Numero decimale    = %d\n",numero);
   }
}

Inserire un numero esadecimale o qualunque altra cosa diversa per uscire:
Numero esadecimale = 231
Numero decimale    = 561
Numero esadecimale = f5e
Numero decimale    = 3934
Numero esadecimale = 1
Numero decimale    = 1
Numero esadecimale = 0
Numero decimale    = 0

#include <stdio.h>
int main()
{
    char text[20];
    float number;
    printf("Inserire i dati:\n");
    scanf("%s %*d %f", text, &number);
    printf("output: %s %f\n", text, number);
    return 0;
}

Inserire i dati:
output: prova 0.523000

#include <stdio.h>
int main()
{
    int val = 123;
    char buf[100];
    sprintf(buf, "%p", (void*)&val);
    printf("Original =%s\n", buf);
    void *ptr;
    sscanf(buf, "%p", &ptr);
    printf("Read back=%p\n", ptr);
    int *iPtr = ptr;
    if (iPtr == &val) {
        printf("Pointers match\n");
    }
}

scanf è vulnerabile ai format string attacks^[17]. Bisogna pertanto prestare grande cura nell'assicurarsi che la stringa di formattazione contenga delle limitazioni riguardo la grandezza degli array (e quindi anche delle stringe) che vengono passati. In molti casi è arbitraria la grandezza della stringa inserita dall'utente e non può essere determinata prima che scanf venga eseguita. Ciò significa che i definitori di formato usati senza un limitatore di lunghezza sono intrinsecamente non sicuri e sfruttabili tramite buffer overflows.

Un'ulteriore vulnerabilità riguarda il permesso ad usare stringhe di formato dinamiche (dynamic formatting strings^[18]), per esempio stringhe di formattazione contenute in file di configurazione o altri file accessibili dall'utente e di cui ne detenga i permessi di modifica. Un attacco noto che sfrutta questo genere di vulnerabilità è SQL injection.

Per questi ed altri motivi, ad oggi scanf viene messa in secondo piano durante l'apprendimento del C/C++, propendendo piuttosto verso fgets per l'acquisizione della riga, per poi passare la stessa a sscanf per scomporla (entrambe funzioni anch'esse contenute all'interno di stdio.h).^[19]

• Canali standard
• printf

Portale Informatica: accedi alle voci di Teknopedia che trattano di informatica