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

CKTIS / Python

isinstance()

Verifica se um objeto pertence a um tipo, incluindo subclasses.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

isinstance(object, classinfo, /)

Verifica se um objeto pertence a um tipo, incluindo subclasses.

Num tuplo ou união o teste para na primeira correspondência. Para True a alternativa int antes de list[int] dá True, mas chegar a list[int] para texto gera TypeError. True tem tipo exato bool mas passa no teste int. Um tuplo ou união de tipos indica alternativas. O texto "1" não é int nem float e não é convertido.

Classes base abstratas podem reconhecer subclasses virtuais.

assert isinstance(True, int | list[int])
try:
    isinstance("x", (int, list[int]))
except TypeError:
    pass
else:
    raise AssertionError
assert type(True) is bool and isinstance(True, int)
assert isinstance("a", str | bytes) and not isinstance("1", (int, float))

Exemplos

print(isinstance(True, int))
print(isinstance("1", (int, float)))

Resultado

True
False

Classes base abstratas podem reconhecer subclasses virtuais.

Fontes