CKTIS / C
atoi — funkcja biblioteki C23
`atoi(const char *nptr)` z `<stdlib.h>` konwertuje początkową dziesiętną liczbę całkowitą z napisu i zwraca `int`. Pomija początkowe białe znaki, rozpoznaje opcjonalny znak i kończy przed pierwszym niepasującym znakiem.
Wersja: C23
Składnia
int atoi(const char *nptr);atoi(const char *nptr) z <stdlib.h> konwertuje początkową dziesiętną liczbę całkowitą z napisu i zwraca int. Pomija początkowe białe znaki, rozpoznaje opcjonalny znak i kończy przed pierwszym niepasującym znakiem.
Może służyć tylko do małych, wcześniej zweryfikowanych wartości konfiguracyjnych. Przykład rzeczywiście przekazuje " -42items", więc otrzymuje -42 i ignoruje przyrostek items.
Brak cyfr zwraca 0, nieodróżnialne od poprawnego zera. Jeśli wynik nie mieści się w int, C23 określa zachowanie jako niezdefiniowane; nptr nie może być NULL. Dla niezaufanego tekstu użyj strtol, sprawdź wskaźnik końca, errno oraz zakres INT_MIN..INT_MAX.
Przykłady
#include <stdio.h>
#include <stdlib.h>
int main(void) {
int count = atoi(" -42items");
printf("%d\n", count);
return 0;
}
Wynik
-42
Może służyć tylko do małych, wcześniej zweryfikowanych wartości konfiguracyjnych. Przykład rzeczywiście przekazuje `" -42items"`, więc otrzymuje `-42` i ignoruje przyrostek `items`.