Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła