Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes