Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strtoull — testo a unsigned long long

strtoull converte la parte iniziale di una stringa in unsigned long long; endptr permette di rilevare una conversione assente e il testo rimanente.

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

Sintassi

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

strtoull, dichiarata in <stdlib.h>, salta gli spazi iniziali e accetta + o -. base va da 2 a 36 oppure è 0 per il riconoscimento automatico della base. C23 include i prefissi 0b/0B; il supporto dell’ambiente di esecuzione non è attestato.

Se endptr non è nullo, *endptr indica il primo carattere non elaborato. Se non avviene alcuna conversione, viene restituito 0 e vale *endptr == nptr. Azzera errno prima della chiamata: in caso di overflow viene restituito ULLONG_MAX con ERANGE. Il risultato, da solo, non basta a convalidare l’input.

Il segno meno non viene rifiutato: "-1" produce ULLONG_MAX. Se i valori negativi non sono consentiti, controlla il segno separatamente. Per una convalida completa occorre controllare anche la fine della stringa.

Esempi

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

int main(void)
{
    const char *text = "12345";
    char *end;
    errno = 0;
    unsigned long long value = strtoull(text, &end, 10);

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return 1;
    }
    printf("%llu\n", value);
    return 0;
}

Risultato

12345

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