Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje