.\" -*- 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 "5 fevereiro 2023" "Linux man\-pages 6.03" .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 \fP .PP \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 .PP .RS -4 Requisitos de macro de teste de recursos para o glibc (consulte \fBfeature_test_macros\fP(7)): .RE .PP \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 .PP .in +4n .EX strtol(nptr, NULL, 10); .EE .in .PP exceto que \fBatoi\fP() mas não faz detecção de erros. .PP 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). .ad l .nh .TS allbox; lbx lb lb l l l. Interface Atributo Valor T{ \fBatoi\fP(), \fBatol\fP(), \fBatoll\fP() T} Thread safety MT\-Safe locale .TE .hy .ad .sp 1 .SH PADRÕES .\" .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. POSIX.1\-2001, POSIX.1\-2008, C99, SVr4, 4.3BSD. .SH NOTAS 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 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 , André Luiz Fassone e Rafael Fontenelle . . .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 .