.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\" References consulted:
.\"     Linux libc source code
.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\"     386BSD man pages
.\" Modified Mon Mar 29 22:39:41 1993, David Metcalfe
.\" Modified Sat Jul 24 21:38:42 1993, Rik Faith (faith@cs.unc.edu)
.\" Modified Sun Dec 17 18:35:06 2000, Joseph S. Myers
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH atoi 3 "2 maio 2024" "Linux man\-pages 6.8" 
.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
A função \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 and POSIX.1\-1996 include the functions \fBatoi\fP()  and \fBatol\fP()  only.
.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 .