Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

atoi — funzione di libreria C23

`atoi(const char *nptr)` di `<stdlib.h>` converte l’intero decimale iniziale di una stringa e restituisce `int`. Salta gli spazi iniziali, accetta un segno facoltativo e si ferma al primo carattere estraneo al numero.

Versione: C23

Sintassi

int atoi(const char *nptr);

atoi(const char *nptr) di <stdlib.h> converte l’intero decimale iniziale di una stringa e restituisce int. Salta gli spazi iniziali, accetta un segno facoltativo e si ferma al primo carattere estraneo al numero.

Usala solo per piccoli valori di configurazione già convalidati. L’esempio passa davvero " -42items", quindi ottiene -42 e ignora il suffisso items.

Senza cifre restituisce 0, indistinguibile da uno zero valido. Se il risultato non è rappresentabile come int, in C23 il comportamento è indefinito; nptr non può essere NULL. Per testo non fidato usa strtol controllando puntatore finale, errno e INT_MIN..INT_MAX.

Esempi

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    int count = atoi("  -42items");
    printf("%d\n", count);
    return 0;
}

Risultato

-42

Usala solo per piccoli valori di configurazione già convalidati. L’esempio passa davvero `" -42items"`, quindi ottiene `-42` e ignora il suffisso `items`.

Fonti