CKTIS / C
strtoll — pretvorba teksta u long long
strtoll na početku teksta čita cijeli broj s neobveznim predznakom i pretvara ga u long long. Rezultat možete provjeriti pomoću endptr i errno.
Verzija: 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 preskače početne bjeline i prihvaća neobvezni + ili -. base mora biti 0 ili u rasponu od 2 do 36. Ako je vrijednost 0, funkcija prepoznaje bazu: decimalnu, oktalnu (0), heksadekadsku (0x) ili binarnu (0b). C23 prihvaća i 0b uz bazu 2; podrška u produkcijskim okruženjima izvođenja nije potvrđena.
Ako endptr nije NULL, funkcija u *endptr sprema adresu prvog nepretvorenog znaka. Ako ne dođe do pretvorbe, funkcija vraća 0, a ako endptr nije NULL, vrijedi *endptr == nptr. Za vrijednost izvan raspona funkcija vraća LLONG_MIN ili LLONG_MAX i vrijedi errno == ERANGE. Prije poziva postavite errno = 0.
Sam rezultat 0 ne znači da je došlo do pogreške. Da biste odbacili sve znakove iza cijelog broja, proslijedite endptr različit od NULL i redom provjerite je li došlo do pretvorbe, je li pretvorba prošla bez pogreške zbog vrijednosti izvan raspona (errno != ERANGE) i vrijedi li **endptr == '\0'. Posljednja provjera odbacuje i završne bjeline koje su ostale nepretvorene. C23 dopušta razdjelnike znamenki (') u cjelobrojnim konstantama u izvornom kôdu, ali strtoll primjenjuje zasebna pravila pretvorbe. Uz lokalne postavke C, kad je base jednak 0, ta pravila izričito isključuju sufikse i razdjelnike znamenki iz zapisa u obliku cjelobrojne konstante. Za baze od 2 do 36 niz znamenki ne sadržava razdjelnike, a zapis ne predviđa zaseban sufiks. Uz druge lokalne postavke mogu se prihvatiti dodatni oblici svojstveni tim postavkama, pa ne treba pretpostaviti da će se razdjelnici skupina znamenki uvijek odbaciti.
Primjeri
#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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.