CKTIS / C
strtoll — pretvorba besedila v long long
strtoll na začetku besedila prebere celo število z neobveznim predznakom in ga pretvori v long long. Rezultat pretvorbe lahko preverite z endptr in errno.
Različica: C23; repository compiler flag, production runtime not attested
Sintaksa
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll preskoči začetne bele znake in sprejme neobvezni + ali -. base mora biti 0 ali med 2 in 36. Pri vrednosti 0 funkcija prepozna osnovo: desetiško, osmiško (0), šestnajstiško (0x) ali dvojiško (0b). C23 dovoljuje tudi 0b pri osnovi 2; podpora v produkcijskih izvajalnih okoljih ni potrjena.
Če endptr ni NULL, funkcija v *endptr shrani naslov prvega nepretvorjenega znaka. Če do pretvorbe ne pride, funkcija vrne 0, pri endptr, ki ni NULL, pa velja *endptr == nptr. Pri vrednosti zunaj obsega funkcija vrne LLONG_MIN ali LLONG_MAX in velja errno == ERANGE. Pred klicem nastavite errno = 0.
Rezultat 0 sam po sebi ne pomeni napake. Če želite zavrniti vse znake za celim številom, podajte endptr, ki ni NULL, in po vrsti preverite, ali je do pretvorbe prišlo, ali je pretvorba potekala brez napake zaradi vrednosti zunaj obsega (errno != ERANGE) in ali velja **endptr == '\0'. Zadnje preverjanje zavrne tudi končne bele znake, ki so ostali nepretvorjeni. C23 dovoljuje ločila med števkami (') v celoštevilskih konstantah v izvorni kodi, vendar strtoll uporablja ločena pravila pretvorbe. Pri območnih nastavitvah C, ko je base enak 0, ta pravila iz zapisa v obliki celoštevilske konstante izrecno izključujejo pripone in ločila med števkami. Pri osnovah od 2 do 36 zaporedje števk ne vsebuje ločil, zapis pa ne predvideva ločene pripone. Pri drugih območnih nastavitvah so lahko sprejete dodatne, zanje značilne oblike, zato ne predpostavljajte, da bodo ločila med skupinami števk vedno zavrnjena.
Primeri
#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;
}Rezultat
-4200
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.