CKTIS / C
strtoll — konwersja tekstu na long long
strtoll odczytuje początkową liczbę całkowitą ze znakiem jako long long. endptr i errno pozwalają sprawdzić wynik konwersji.
Wersja: C23; repository compiler flag, production runtime not attested
Składnia
#include <stdlib.h>
long long int strtoll(const char *restrict nptr, char **restrict endptr, int base);strtoll pomija początkowe białe znaki i przyjmuje opcjonalny + lub -. base musi wynosić 0 albo 2–36. 0 wykrywa podstawę: dziesiętną, ósemkową (0), szesnastkową (0x) lub binarną (0b). C23 dopuszcza też 0b przy podstawie 2; obsługa w produkcyjnym środowisku wykonawczym nie jest potwierdzona.
Jeśli endptr nie jest NULL, funkcja zapisuje w *endptr adres pierwszego nieprzetworzonego znaku. Jeśli konwersja nie nastąpi, funkcja zwraca 0 i przy endptr różnym od NULL zachodzi *endptr == nptr. Przekroczenie zakresu daje LLONG_MIN albo LLONG_MAX oraz errno == ERANGE. Przed wywołaniem ustaw errno = 0.
Sam wynik 0 nie oznacza błędu. Aby odrzucić wszelkie znaki po liczbie, przekaż endptr różne od NULL i sprawdź kolejno, czy konwersja nastąpiła, czy nie przekroczono zakresu i czy **endptr == '\0'. Ten ostatni warunek odrzuca również końcowe białe znaki, które pozostały nieprzetworzone. C23 dopuszcza separatory cyfr (') w stałych całkowitych w kodzie źródłowym, ale strtoll stosuje odrębne reguły konwersji. W ustawieniach regionalnych C, gdy base wynosi 0, reguły te wyraźnie wykluczają sufiksy i separatory cyfr z postaci stałej całkowitej. Dla podstaw od 2 do 36 zapis obejmuje ciąg cyfr bez separatorów i nie przewiduje osobnego sufiksu. Przy innych ustawieniach regionalnych mogą być akceptowane dodatkowe formy zależne od tych ustawień, więc nie należy zakładać, że separatory grup cyfr będą zawsze odrzucane.
Przykłady
#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;
}Wynik
-4200
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.