Man page - atol(3)

Packages contains this manual

Available languages:

en fr pt_BR es pl cs ja ru ro de

Manual

atoi

NOME
BIBLIOTECA
SINOPSE
DESCRIÇÃO
VALOR DE RETORNO
ATRIBUTOS
VERSÕES
PADRÕES
HISTÓRICO
BUGS
VEJA TAMBÉM
TRADUÇÃO

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

Image grohtml-3940750-1.png

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 e POSIX.1-1996 incluem as funções atoi () e atol () apenas.

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