atol

ATOI(3)                  Manual do Programador do Linux                  ATOI(3)



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

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

DE ACORDO COM
       POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD. C89 e POSIX.1-1996 incluem
       as funções atoi() e atol() apenas.

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)

COLOFÃO
       Esta página faz parte da versão 5.13 do projeto Linux man-pages. Uma
       descrição do projeto, informações sobre relatórios de bugs e a versão
       mais recente desta página podem ser encontradas em
       https://www.kernel.org/doc/man-pages/.


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



GNU                               22 março 2021                          ATOI(3)