Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

atol — funkcja biblioteki C23

`atol(const char *nptr)` z `<stdlib.h>` czyta początkową dziesiętną liczbę całkowitą i zwraca `long int`. Pomija białe znaki, akceptuje opcjonalny znak i zatrzymuje się przy pierwszym znaku spoza liczby.

Wersja: C23

Składnia

long int atol(const char *nptr);

atol(const char *nptr) z <stdlib.h> czyta początkową dziesiętną liczbę całkowitą i zwraca long int. Pomija białe znaki, akceptuje opcjonalny znak i zatrzymuje się przy pierwszym znaku spoza liczby.

Pasuje do wcześniej zweryfikowanych liczników używanych przez interfejsy o typie long. Przykład rzeczywiście konwertuje "+123456ms" na 123456 i drukuje wynik właściwym formatem %ld.

Szerokość long zależy od platformy i może wynosić tylko 32 bity. Brak cyfr daje niejednoznaczne 0, a wynik poza zakresem LONG_MIN..LONG_MAX ma w C23 niezdefiniowane zachowanie; nptr nie może być NULL. strtol zapewnia kontrolę końca i zakresu.

Przykłady

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    long count = atol("+123456ms");
    printf("%ld\n", count);
    return 0;
}

Wynik

123456

Pasuje do wcześniej zweryfikowanych liczników używanych przez interfejsy o typie `long`. Przykład rzeczywiście konwertuje `"+123456ms"` na `123456` i drukuje wynik właściwym formatem `%ld`.

Źródła