HOWTO · C

Converti una stringa in numero intero in C

Questo articolo introduce diversi metodi in C per convertire una stringa in un numero intero

In questa pagina

Convertire una stringa C in un numero intero dipende dai dati di input che si accettano e dai controlli richiesti dal programma. La libreria standard mette a disposizione atoi(), strtol() e strtoumax(). Usa atoi() solo se l’input è già attendibile; se può essere malformato o fuori dall’intervallo del tipo di destinazione, preferisci una conversione con controlli tramite strtol() o strtoumax().

Usare atoi() per convertire una stringa in un numero intero in C

atoi(), dichiarata in <stdlib.h>, ignora gli spazi iniziali, legge un eventuale segno e le cifre decimali, quindi si ferma al primo carattere che non fa parte del numero. Restituisce un int, ma la sua interfaccia non indica dove si è fermata la lettura né consente di distinguere uno zero valido da una conversione non riuscita. Se il valore convertito non è rappresentabile come int, il comportamento è indefinito. Usala solo quando il formato e l’intervallo dell’input sono garantiti in altro modo.

Esegui questo esempio:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    int value = atoi(input);
    printf("%s -> %d\n", input, value);
    return 0;
}

Output osservato. Le eventuali etichette testuali stampate dall’esempio restano in inglese, poiché il blocco di codice è mantenuto identico al canonico:

123 -> 123

Usare strtol() per convertire una stringa in un numero intero in C

strtol() è dichiarata in <stdlib.h> e restituisce un long. Accetta una base compresa tra 2 e 36: la base 10 legge numeri decimali, mentre la base 0 riconosce i consueti prefissi interi del C. Ignora gli spazi iniziali e si ferma al primo carattere che non appartiene al numero. Passa l’indirizzo di un puntatore finale per individuare quel punto. Se il puntatore finale indica ancora il primo carattere dell’input, non è stata convertita alcuna cifra; se dopo la conversione indica un carattere diverso da null, l’input contiene un suffisso finale.

Prima di chiamare strtol(), imposta errno a zero. Se il risultato è uguale a LONG_MIN o LONG_MAX e errno == ERANGE, il valore era fuori dall’intervallo di long. Se la destinazione è int, controlla anche INT_MIN e INT_MAX prima del cast. Questo esempio completo accetta solo un valore decimale intero che rientra in un int:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

#include <errno.h>
#include <limits.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    char *end;
    errno = 0;
    long parsed = strtol(input, &end, 10);

    if (end == input || *end != '\0' || errno == ERANGE ||
        parsed < INT_MIN || parsed > INT_MAX) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%d\n", (int)parsed);
    return 0;
}

Output osservato. Le eventuali etichette testuali stampate dall’esempio restano in inglese, poiché il blocco di codice è mantenuto identico al canonico:

value=123

Nel codice di produzione, stabilisci se accettare spazi circostanti o un suffisso finale: strtol() consente gli spazi iniziali e il controllo del puntatore finale mostrato sopra rifiuta qualsiasi suffisso dopo le cifre.

Usare strtoumax() per convertire una stringa in un numero intero in C

strtoumax() è dichiarata in <inttypes.h> e converte il valore in uintmax_t, il tipo intero senza segno più ampio fornito dall’implementazione. Come strtol(), accetta un puntatore finale e una base e, dopo che errno è stato azzerato, segnala un superamento dell’intervallo tramite errno == ERANGE. Includi <stdint.h> per il tipo uintmax_t e <inttypes.h> per la funzione e la macro di formattazione PRIuMAX.

Una conversione senza segno può accettare un segno meno iniziale e produrre un risultato senza segno secondo le regole della funzione. Se l’applicazione richiede un input non negativo, rifiuta esplicitamente il segno meno. L’esempio seguente richiede inoltre almeno una cifra, rifiuta i caratteri finali e stampa il valore con la macro di formato corrispondente:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

#include <ctype.h>
#include <errno.h>
#include <inttypes.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

int main(void) {
    const char *input = "123";
    const char *sign = input;
    while (isspace((unsigned char)*sign)) {
        ++sign;
    }

    if (*sign == '-') {
        puts("conversion failed");
        return 0;
    }

    char *end;
    errno = 0;
    uintmax_t value = strtoumax(input, &end, 10);
    if (end == input || *end != '\0' || errno == ERANGE) {
        puts("conversion failed");
        return 0;
    }

    printf("value=%" PRIuMAX "\n", value);
    return 0;
}

Output osservato. Le eventuali etichette testuali stampate dall’esempio restano in inglese, poiché il blocco di codice è mantenuto identico al canonico:

value=123

Il risultato è senza segno e può essere più ampio di int; prima di convertirlo in un tipo più stretto, confronta il valore con il limite massimo del tipo di destinazione.

Scegliere una funzione C per convertire una stringa in un numero intero

Scegli atoi() quando l’input è attendibile, rientra in int e il programma non deve distinguere un input malformato da uno zero. Per l’input dell’utente, i file o altri dati che potrebbero non rispettare il formato previsto, strtol() è in genere la conversione con segno più adatta, perché il puntatore finale e errno consentono di convalidare il risultato. Controlla sia l’intervallo di long sia quello di qualsiasi tipo di destinazione più stretto.

Scegli strtoumax() per una quantità non negativa che potrebbe superare il limite positivo di long. Verifica che siano state lette delle cifre, rifiuta il testo finale quando l’intera stringa deve essere numerica, controlla ERANGE e applica eventuali limiti più stretti specifici dell’applicazione. Nessuna delle due funzioni con controlli stabilisce che cosa sia accettabile per la tua applicazione: chi le chiama deve definire se consentire spazi, segni, prefissi o caratteri finali, quindi verificare tali regole prima di usare il risultato.