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 │
       └──────────────────────────────────────────────────────────────────────┴───────────────┴────────────────┘

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.

Linux man-pages 6.9.1                              2 maio 2024                                           atoi(3)