Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła