Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

int: inteiros e conversão de dados

int cria um inteiro a partir de um número ou texto adequado. A conversão de vírgula flutuante trunca a parte fracionária em direção a zero, sem arredondar ao inteiro mais próximo.

Versão: Python 3.14

Sintaxe

int(number=0, /)
int(string, /, base=10)

Sem argumentos, int() produz 0. int(" 12 ") aceita os espaços em redor, mas int("3.9") provoca ValueError: esse texto não representa um inteiro. Em contrapartida, int(-3.9) produz -3, não -4. É truncagem, não a operação floor.

Para texto podes indicar uma base: int("ff", 16) produz 255. As bases válidas vão de 2 a 36, ou 0 para reconhecer prefixos permitidos como 0x. A base 0 não trata qualquer zero inicial como notação decimal normal. Uma base explícita exige entrada textual ou em bytes, não um número de vírgula flutuante.

Texto inválido provoca ValueError, e um tipo não suportado pode provocar TypeError. O infinito não pode ser convertido em int: gera OverflowError. Após a conversão, verifica também as restrições do domínio, como idades ou quantidades permitidas.

Os inteiros Python não têm largura fixa, mas continuam limitados pela memória e pelo tempo disponíveis. Conversões de representações muito longas podem estar sujeitas ao limite de algarismos do interpretador. Não desatives essa proteção para entradas não fiáveis só para ocultar um erro.

Exemplos

print(int(" 12 "), int("ff", 16), int(-3.9))
try:
    int("3.9")
except ValueError:
    print("ValueError")
try:
    int(float("inf"))
except OverflowError:
    print("OverflowError")

Resultado

12 255 -3
ValueError
OverflowError

Fontes