CKTIS / C
atoi — função de biblioteca C23
`atoi(const char *nptr)` de `<stdlib.h>` converte o inteiro decimal inicial de uma string e devolve `int`. Ignora espaços iniciais, aceita sinal opcional e termina no primeiro caráter que não pertence ao número.
Versão: C23
Sintaxe
int atoi(const char *nptr);atoi(const char *nptr) de <stdlib.h> converte o inteiro decimal inicial de uma string e devolve int. Ignora espaços iniciais, aceita sinal opcional e termina no primeiro caráter que não pertence ao número.
Usa-a apenas para pequenos valores de configuração previamente validados. O exemplo passa realmente " -42items", obtém -42 e ignora o sufixo items.
Sem algarismos devolve 0, indistinguível de um zero válido. Se o resultado não for representável em int, C23 torna o comportamento indefinido; nptr não pode ser NULL. Para texto não fiável usa strtol e verifica ponteiro final, errno e INT_MIN..INT_MAX.
Exemplos
#include <stdio.h>
#include <stdlib.h>
int main(void) {
int count = atoi(" -42items");
printf("%d\n", count);
return 0;
}
Resultado
-42
Usa-a apenas para pequenos valores de configuração previamente validados. O exemplo passa realmente `" -42items"`, obtém `-42` e ignora o sufixo `items`.