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`.