Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła