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.