CKTIS / C
strtol — převod textu na long
strtol načte celé číslo typu long od začátku textu. Kontrolujte endptr a errno, abyste zjistili chyby a případný nezpracovaný zbytek.
Verze: C23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);strtol z <stdlib.h> přeskočí počáteční bílé znaky, přijímá volitelné znaménko + nebo - a převádí číslice na long.
base musí být 0 nebo v rozsahu 2–36. Hodnota 0 rozpozná desítkový, osmičkový (0), šestnáctkový (0x) a v C23 také binární zápis (0b). Výslovně zadané základy 16 a 2 umožňují příslušné předpony. Příznak kompilátoru C23 nepotvrzuje podporu v běhové knihovně.
Pokud endptr != NULL, ukazuje *endptr na první nezpracovaný znak. Pokud nedojde k žádnému převodu, vrátí se 0 a platí *endptr == nptr; samotná hodnota 0 neznamená chybu.
Před voláním nastavte errno = 0. Hodnota mimo rozsah vrací LONG_MIN nebo LONG_MAX a nastavuje ERANGE. Pokud endptr != NULL a požadujete zpracování celého textu, zkontrolujte také **endptr == '\0': s ukončovacím znakem řetězce porovnávejte znak, na který *endptr ukazuje, nikoli samotný ukazatel. V národním prostředí C zůstávají koncové bílé znaky nezpracované. V jiných národních prostředích může funkce přijímat další formy zápisu specifické pro dané prostředí. Dosažení ukončovacího znaku potvrzuje, že byl zpracován celý řetězec, nikoli že vstup odpovídá pravidlům zápisu národního prostředí C.
Pří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ýsledek
value=123
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.