Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strtoll — convertire testo in long long

strtoll legge un intero con segno all’inizio del testo e lo converte in long long. endptr ed errno consentono di controllare il risultato della conversione.

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

Sintassi

#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);

strtoll ignora gli spazi bianchi iniziali e accetta un + o un - facoltativo. base deve essere 0 oppure un valore compreso tra 2 e 36. Con 0 viene rilevata la base: decimale, ottale (0), esadecimale (0x) o binaria (0b). C23 accetta anche 0b con base 2; il supporto negli ambienti di esecuzione di produzione non è attestato.

Se endptr è diverso da NULL, la funzione memorizza in *endptr l’indirizzo del primo carattere non convertito. Se non avviene alcuna conversione, la funzione restituisce 0 e, quando endptr è diverso da NULL, vale *endptr == nptr. Per un valore fuori intervallo, la funzione restituisce LLONG_MIN o LLONG_MAX e vale errno == ERANGE. Imposta errno = 0 prima della chiamata.

Un risultato pari a 0 da solo non indica un errore. Per rifiutare qualsiasi carattere dopo l’intero, passa un endptr diverso da NULL e verifica, nell’ordine, che la conversione sia avvenuta, che non ci siano errori di intervallo e che valga **endptr == '\0'. Quest’ultimo controllo esclude anche gli spazi bianchi finali rimasti non convertiti. C23 ammette i separatori di cifre (') nelle costanti intere del codice sorgente, ma strtoll applica regole di conversione distinte. Nelle impostazioni locali C, quando base è 0, queste regole escludono esplicitamente i suffissi e i separatori di cifre dalla forma delle costanti intere. Per le basi da 2 a 36, la sequenza di cifre non contiene separatori e non è previsto un suffisso distinto. Altre impostazioni locali possono ammettere forme aggiuntive ad esse specifiche, quindi non dare per scontato che i separatori usati per raggruppare le cifre vengano sempre rifiutati.

Esempi

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

int main(void)
{
    const char *text = "-4200";
    char *end;
    errno = 0;
    long long value = strtoll(text, &end, 10);

    if (end == text) {
        puts("no digits");
        return EXIT_FAILURE;
    }
    if (errno == ERANGE) {
        puts("out of range");
        return EXIT_FAILURE;
    }
    if (*end != '\0') {
        puts("trailing characters");
        return EXIT_FAILURE;
    }
    printf("%lld\n", value);
    return EXIT_SUCCESS;
}

Risultato

-4200

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