.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, David Metcalfe <david@prism.demon.co.uk>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH atoi 3 "8 fevereiro 2026" "Linux man\-pages 6.17" 
.SH NOME
atoi, atol, atoll \- converte uma string para um inteiro
.SH BIBLIOTECA
Biblioteca C Padrão (\fIlibc\fP,\ \fI\-lc\fP)
.SH SINOPSE
.nf
\fB#include <stdlib.h>\fP
.P
\fBint atoi(const char *\fP\fInptr\fP\fB);\fP
\fBlong atol(const char *\fP\fInptr\fP\fB);\fP
\fBlong long atoll(const char *\fP\fInptr\fP\fB);\fP
.fi
.P
.RS -4
Requisitos de macro de teste de recursos para o glibc (consulte
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBatoll\fP():
.nf
    _ISOC99_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH DESCRIÇÃO
A função \fBatoi\fP() converte a parte inicial da string \fInptr\fP para \fIint\fP. O
comportamento é o mesmo de
.P
.in +4n
.EX
strtol(nptr, NULL, 10);
.EE
.in
.P
exceto que \fBatoi\fP() mas não faz detecção de erros.
.P
As funções \fBatol\fP() e \fBatoll\fP() fazem o mesmo que \fBatoi\fP(), exceto que
convertem uma porção inicial da string para seu tipo de retorno de \fIlong\fP
ou \fIlong\ long\fP.
.SH "VALOR DE RETORNO"
O valor convertido ou 0 em caso de erro.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Interface	Atributo	Valor
T{
.na
.nh
\fBatoi\fP(),
\fBatol\fP(),
\fBatoll\fP()
T}	Thread safety	MT\-Safe locale
.TE
.SH VERSÕES
POSIX.1 deixa o valor de retorno de \fBatoi\fP() em caso de erro não
especificado. no glibc, musl libc e uClibc, 0 é retornado em caso de erro.
.SH PADRÕES
C11, POSIX.1\-2008.
.SH HISTÓRICO
C99, POSIX.1\-2001, SVr4, 4.3BSD.
.P
.\" .SH NOTES
.\" Linux libc provided
.\" .BR atoq ()
.\" as an obsolete name for
.\" .BR atoll ();
.\" .BR atoq ()
.\" is not provided by glibc.
.\" The
.\" .BR atoll ()
.\" function is present since glibc 2.0.2, but
.\" not in libc4 or libc5.
C89 e POSIX.1\-1996 incluem as funções \fBatoi\fP() e \fBatol\fP() apenas.
.SH BUGS
\fIerrno\fP 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 \fBstrtol\fP() e \fBstrtoul\fP() em
novos programas.
.SH "VEJA TAMBÉM"
\fBatof\fP(3), \fBstrtod\fP(3), \fBstrtol\fP(3), \fBstrtoul\fP(3)
.PP
.SH 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>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .