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.