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);

   Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

       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.

       A função atol() e atoll() fazem o mesmo  que  atoi(),  exceto  que  convertem  uma  porção
       inicial da string para seu tipo de retorno de long ou 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).

       ┌────────────────────────────────────────────────────────┬───────────────┬────────────────┐
       │Interface                                               │ Atributo      │ Valor          │
       ├────────────────────────────────────────────────────────┼───────────────┼────────────────┤
       │atoi(), atol(), atoll()                                 │ Thread safety │ MT-Safe locale │
       └────────────────────────────────────────────────────────┴───────────────┴────────────────┘

PADRÕES

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

NOTAS

       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.

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
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨debian-l10n-portuguese@lists.debian.org⟩.