CKTIS / C
atol — knihovní funkce C23
`atol(const char *nptr)` z `<stdlib.h>` načte počáteční desítkové celé číslo a vrátí `long int`. Přeskočí bílé znaky, přijme volitelné znaménko a zastaví se u prvního znaku mimo číslo.
Verze: C23
Syntaxe
long int atol(const char *nptr);atol(const char *nptr) z <stdlib.h> načte počáteční desítkové celé číslo a vrátí long int. Přeskočí bílé znaky, přijme volitelné znaménko a zastaví se u prvního znaku mimo číslo.
Hodí se pro předem ověřené čítače používané rozhraními typu long. Příklad skutečně převede "+123456ms" na 123456 a vypíše výsledek správným formátem %ld.
Šířka long závisí na platformě a může být jen 32 bitů. Bez číslic je 0 nejednoznačná; mimo LONG_MIN..LONG_MAX má C23 nedefinované chování a nptr nesmí být NULL. strtol umožní kontrolu konce a rozsahu.
Příklady
#include <stdio.h>
#include <stdlib.h>
int main(void) {
long count = atol("+123456ms");
printf("%ld\n", count);
return 0;
}
Výsledek
123456
Hodí se pro předem ověřené čítače používané rozhraními typu `long`. Příklad skutečně převede `"+123456ms"` na `123456` a vypíše výsledek správným formátem `%ld`.