KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strtoul — tekst omzetten naar unsigned long

Legt uit hoe tekst naar unsigned long wordt omgezet en hoe je het resultaat controleert. Het voorbeeld laat bereikcontrole zien en verwerpt een niet-verwerkt achtervoegsel.

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

Syntax

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

strtoul zet het begin van de tekenreeks nptr om naar unsigned long. Voorafgaande witruimte wordt overgeslagen en + of - wordt geaccepteerd.

base: 2–36 of 0 (automatische detectie: 0 — octaal, 0x/0X — hexadecimaal, 0b/0B — binair in C23, anders decimaal). C23 accepteert het binaire voorvoegsel ook wanneer base == 2.

Als je &end doorgeeft, slaat de functie het adres van het eerste niet-verwerkte teken op in end. Geef je NULL door, dan wordt dat adres niet opgeslagen. Als er geen omzetting plaatsvindt, is het resultaat 0 en geldt end == nptr. Bij overflow zijn het resultaat ULONG_MAX en errno == ERANGE: stel eerst errno = 0 in. Voor een volledige omzetting moet *end == '\0' gelden.

Een minteken is niet automatisch een fout: "-1" levert ULONG_MAX op. Als je negatieve getallen wilt verbieden, wijs dan een minteken na de voorafgaande witruimte af. Een C23-compileroptie bewijst niet dat de runtimebibliotheek C23 ondersteunt.

Voorbeelden

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

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

    if (end == text || errno == ERANGE || *end != '\0') {
        puts("invalid");
        return EXIT_FAILURE;
    }

    printf("value=%lu\n", value);
    return EXIT_SUCCESS;
}

Resultaat

value=42

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