CKTIS / C
strtol — konwersja tekstu na long
strtol odczytuje liczbę typu long z początku tekstu. Sprawdzaj endptr oraz errno, aby wykrywać błędy i nieprzetworzoną końcówkę.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdlib.h>
long int strtol(const char *restrict nptr, char **restrict endptr, int base);strtol z <stdlib.h> pomija początkowe białe znaki, przyjmuje opcjonalny znak + lub - i przetwarza cyfry na long.
base musi wynosić 0 albo 2–36. 0 rozpoznaje zapis dziesiętny, ósemkowy (0), szesnastkowy (0x) i w C23 binarny (0b). Jawne podstawy 16 i 2 dopuszczają odpowiednie prefiksy. Flaga kompilatora C23 nie potwierdza obsługi przez bibliotekę wykonawczą.
Jeżeli endptr != NULL, *endptr wskazuje pierwszy nieprzetworzony znak. Brak konwersji daje 0 i *endptr == nptr; samo 0 nie oznacza błędu.
Przed wywołaniem ustaw errno = 0. Przekroczenie zakresu daje LONG_MIN lub LONG_MAX oraz ERANGE. Jeśli endptr != NULL i wymagany jest pełny odczyt, sprawdź też **endptr == '\0': z terminatorem porównujesz znak wskazywany przez *endptr, a nie sam wskaźnik. W ustawieniach regionalnych C końcowe białe znaki pozostają nieprzetworzone. W innych ustawieniach regionalnych funkcja może akceptować dodatkowe formy zapisu. Dotarcie do terminatora oznacza, że przetworzono cały ciąg, ale nie dowodzi zgodności zapisu z regułami ustawień C.
Przykłady
#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;
}Wynik
value=123
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.