Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strtol — convertire testo in long

strtol legge un intero long dall’inizio di un testo. Controlla endptr ed errno per rilevare errori e qualsiasi suffisso non consumato.

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

Sintassi

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

strtol, dichiarata in <stdlib.h>, ignora gli spazi bianchi iniziali, accetta un + o - facoltativo e converte le cifre in long.

base deve essere 0 oppure compresa tra 2 e 36. Il valore 0 riconosce le notazioni decimale, ottale (0), esadecimale (0x) e, in C23, binaria (0b). Le basi esplicite 16 e 2 consentono i rispettivi prefissi. Un’opzione del compilatore C23 non attesta il supporto della libreria di runtime.

Se endptr != NULL, *endptr punta al primo carattere non consumato. Se non avviene alcuna conversione, viene restituito 0 e *endptr == nptr; il solo valore 0 non indica un errore.

Prima della chiamata, imposta errno = 0. Un valore fuori intervallo restituisce LONG_MIN o LONG_MAX e imposta ERANGE. Se endptr != NULL ed è necessario consumare tutto il testo, controlla anche **endptr == '\0': confronta il carattere a cui punta *endptr con il terminatore della stringa, non il puntatore stesso. Nella locale C, gli spazi bianchi finali non vengono consumati. In altre locale, la funzione può accettare ulteriori formati di input specifici della locale. Raggiungere il terminatore conferma che l’intera stringa è stata consumata, non che l’input rispetti la sintassi della locale C.

Esempi

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

int main(void)
{
    const char *text = "123";
    char *end;
    errno = 0;
    long value = strtol(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("value=%ld\n", value);
    return EXIT_SUCCESS;
}

Risultato

value=123

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