NOME¶

atoi, atol, atoll - converte uma string para um inteiro

BIBLIOTECA¶

Biblioteca C Padrão (libc, -lc)

SINOPSE¶

#include <stdlib.h>

int atoi(const char *nptr);
long atol(const char *nptr);
long long atoll(const char *nptr);

atoll():

    _ISOC99_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIÇÃO¶

A função atoi() converte a parte inicial da string nptr para int. O comportamento é o mesmo de

strtol(nptr, NULL, 10);

exceto que atoi() mas não faz detecção de erros.

The atol() and atoll() functions behave the same as atoi(), except that they convert the initial portion of the string to their return type of long or long long.

VALOR DE RETORNO¶

O valor convertido ou 0 em caso de erro.

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

VERSÕES¶

POSIX.1 deixa o valor de retorno de atoi() em caso de erro não especificado. no glibc, musl libc e uClibc, 0 é retornado em caso de erro.

PADRÕES¶

C11, POSIX.1-2008.

HISTÓRICO¶

C99, POSIX.1-2001, SVr4, 4.3BSD.

C89 e POSIX.1-1996 incluem as funções atoi() e atol() apenas.

BUGS¶

errno não é definido com erro, então não há como distinguir entre 0 como um erro e como o valor convertido. Nenhuma verificação de estouro ou estouro negativo é feita. Apenas a entrada de base 10 pode ser convertida. Em vez disso, é recomendado usar a família de funções strtol() e strtoul() em novos programas.

VEJA TAMBÉM¶

atof(3), strtod(3), strtol(3), strtoul(3)

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Paulo César Mendes <drpc@ism.com.br>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.