CKTIS / C
atoi — knihovní funkce C23
`atoi(const char *nptr)` z `<stdlib.h>` převede počáteční desítkové celé číslo v řetězci a vrátí `int`. Přeskočí úvodní bílé znaky, přijme volitelné znaménko a skončí u prvního znaku, který do čísla nepatří.
Verze: C23
Syntaxe
int atoi(const char *nptr);atoi(const char *nptr) z <stdlib.h> převede počáteční desítkové celé číslo v řetězci a vrátí int. Přeskočí úvodní bílé znaky, přijme volitelné znaménko a skončí u prvního znaku, který do čísla nepatří.
Hodí se jen pro malé, předem ověřené konfigurační hodnoty. Příklad skutečně předá " -42items", získá tedy -42 a příponu items ignoruje.
Bez číslic vrátí 0, což nelze odlišit od platné nuly. Pokud výsledek nelze reprezentovat jako int, C23 stanoví nedefinované chování; nptr nesmí být NULL. Pro nedůvěryhodný text použij strtol a ověř koncový ukazatel, errno a INT_MIN..INT_MAX.
Příklady
#include <stdio.h>
#include <stdlib.h>
int main(void) {
int count = atoi(" -42items");
printf("%d\n", count);
return 0;
}
Výsledek
-42
Hodí se jen pro malé, předem ověřené konfigurační hodnoty. Příklad skutečně předá `" -42items"`, získá tedy `-42` a příponu `items` ignoruje.