Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

strtoll — prevod textu na long long

strtoll prečíta zo začiatku textu celé číslo s voliteľným znamienkom ako long long. Výsledok prevodu možno skontrolovať pomocou endptr a errno.

Verzia: 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 preskočí počiatočné biele znaky a prijíma voliteľné + alebo -. base musí byť 0 alebo v rozsahu 2–36. Pri hodnote 0 funkcia rozpozná základ: desiatkový, osmičkový (0), šestnástkový (0x) alebo dvojkový (0b). C23 povoľuje aj 0b pri základe 2; podpora v produkčných prostrediach vykonávania nie je potvrdená.

Ak endptr nie je NULL, funkcia uloží do *endptr adresu prvého neprevedeného znaku. Ak sa prevod neuskutoční, funkcia vráti 0, a ak endptr nie je NULL, platí *endptr == nptr. Pri hodnote mimo rozsahu funkcia vráti LLONG_MIN alebo LLONG_MAX a platí errno == ERANGE. Pred volaním nastavte errno = 0.

Samotný výsledok 0 neznamená chybu. Ak chcete odmietnuť všetky znaky za celým číslom, odovzdajte v endptr ukazovateľ rôzny od NULL a postupne overte, že sa prevod uskutočnil, že prevod neskončil chybou rozsahu (errno != ERANGE) a že platí **endptr == '\0'. Posledná kontrola odmietne aj koncové biele znaky, ktoré zostali neprevedené. C23 povoľuje oddeľovače číslic (') v celočíselných konštantách v zdrojovom kóde, ale strtoll používa vlastné pravidlá prevodu. Pri miestnom nastavení C, ak má base hodnotu 0, tieto pravidlá výslovne vylučujú prípony a oddeľovače číslic zo zápisu v tvare celočíselnej konštanty. Pri základoch od 2 do 36 postupnosť číslic neobsahuje oddeľovače a zápis nemá samostatnú príponu. Iné miestne nastavenia môžu povoľovať ďalšie tvary, ktoré sú pre ne špecifické. Nemožno teda predpokladať, že oddeľovače skupín číslic budú vždy odmietnuté.

Príklady

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

Výsledok

-4200

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje