KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

strtoll — tekst omzetten naar long long

strtoll leest aan het begin van de tekst een geheel getal met een optioneel teken in als long long. Met endptr en errno kun je de omzetting controleren.

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

Syntax

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

strtoll slaat voorafgaande witruimte over en accepteert optioneel een + of -. base moet 0 zijn of tussen 2 en 36 liggen. Met 0 wordt het grondtal automatisch bepaald: decimaal, octaal (0), hexadecimaal (0x) of binair (0b). C23 accepteert ook 0b bij grondtal 2; ondersteuning in productieomgevingen is niet bevestigd.

Als endptr niet NULL is, slaat de functie het adres van het eerste niet-omgezette teken op in *endptr. Als er geen omzetting plaatsvindt, retourneert de functie 0 en geldt *endptr == nptr wanneer endptr niet NULL is. Bij een waarde buiten het bereik wordt LLONG_MIN of LLONG_MAX teruggegeven en geldt errno == ERANGE. Stel vóór de aanroep errno = 0 in.

Een resultaat van 0 betekent op zichzelf niet dat er een fout is. Wil je alle tekens na het gehele getal afwijzen, geef dan voor endptr een aanwijzer mee die niet NULL is. Controleer achtereenvolgens of er een omzetting heeft plaatsgevonden, of er geen bereikfout is en of **endptr == '\0' geldt. De laatste controle wijst ook afsluitende witruimte af die niet is omgezet. C23 staat cijferscheidingstekens (') toe in gehele constanten in broncode, maar strtoll hanteert aparte omzettingsregels. In de C-locale sluiten die regels bij base gelijk aan 0 suffixen en cijferscheidingstekens uitdrukkelijk uit van de notatie als gehele constante. Voor grondtallen van 2 tot en met 36 bevat de cijferreeks geen scheidingstekens en is er geen afzonderlijk suffix. Andere locales kunnen aanvullende, locale-specifieke vormen accepteren. Ga er dus niet van uit dat scheidingstekens tussen groepen cijfers altijd worden afgewezen.

Voorbeelden

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

Resultaat

-4200

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