CKTIS / C
strtol — prevod textu na long
strtol načíta celé číslo typu long od začiatku textu. Kontrolujte endptr a errno, aby ste zistili chyby a prípadný nespracovaný zvyšok.
Verzia: C23; repository compiler flag, production runtime not attested
Syntax
#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);strtol z <stdlib.h> preskočí úvodné biele znaky, prijíma voliteľné znamienko + alebo - a prevádza číslice na long.
base musí byť 0 alebo v rozsahu 2–36. Hodnota 0 rozpozná desiatkový, osmičkový (0), šestnástkový (0x) a v C23 aj binárny zápis (0b). Výslovne zadané základy 16 a 2 umožňujú príslušné predpony. Príznak kompilátora C23 nepotvrdzuje podporu v runtime knižnici.
Ak endptr != NULL, *endptr ukazuje na prvý nespracovaný znak. Ak nedôjde k žiadnemu prevodu, vráti sa 0 a platí *endptr == nptr; samotná hodnota 0 neznamená chybu.
Pred volaním nastavte errno = 0. Hodnota mimo rozsahu vracia LONG_MIN alebo LONG_MAX a nastavuje ERANGE. Ak endptr != NULL a požadujete spracovanie celého textu, skontrolujte aj **endptr == '\0': s ukončovacím znakom reťazca porovnajte znak, na ktorý ukazuje *endptr, nie samotný ukazovateľ. Pri miestnych nastaveniach C zostávajú koncové biele znaky nespracované. Pri iných miestnych nastaveniach môže funkcia prijímať aj ďalšie formy zápisu špecifické pre dané nastavenia. Dosiahnutie ukončovacieho znaku potvrdzuje, že sa spracoval celý reťazec, nie že vstup zodpovedá pravidlám zápisu miestnych nastavení C.
Príklady
#include <errno.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
const char *text = "123";
char *end;
errno = 0;
long value = strtol(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("value=%ld\n", value);
return EXIT_SUCCESS;
}Výsledok
value=123
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.