KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strtoull — tekst naar unsigned long long

strtoull zet het begin van een tekenreeks om naar unsigned long long; met endptr kun je een ontbrekende conversie en resterende tekst herkennen.

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

Syntax

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

strtoull uit <stdlib.h> slaat voorafgaande witruimte over en accepteert + of -. base is 2–36 of 0 voor automatische basisdetectie. C23 omvat de voorvoegsels 0b/0B; ondersteuning door de runtime is niet bevestigd.

Als endptr niet null is, wijst *endptr naar het eerste niet-verwerkte teken. Als er geen conversie plaatsvindt, wordt 0 teruggegeven en geldt *endptr == nptr. Zet errno vooraf op 0: bij overflow wordt ULLONG_MAX met ERANGE teruggegeven. Alleen de resultaatwaarde is niet genoeg om de invoer te valideren.

Een minteken wordt niet afgewezen: "-1" levert ULLONG_MAX op. Controleer het teken apart als negatieve invoer niet is toegestaan. Voor volledige validatie moet ook het einde van de tekenreeks worden gecontroleerd.

Voorbeelden

#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;
}

Resultaat

12345

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen