Provided by: manpages-pt-br-dev_4.23.1-1_all
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 and POSIX.1-1996 include the functions atoi() and atol() only.
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⟩.