Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

isinstance()

Teste l’appartenance d’un objet à un type en incluant les sous-classes.

Version : Python 3.14; repository image, production runtime not attested

Syntaxe

isinstance(object, classinfo, /)

Teste l’appartenance d’un objet à un type en incluant les sous-classes.

Avec un tuple ou une union le test s’arrête au premier succès. Pour True l’alternative int précédant list[int] donne True, mais atteindre list[int] pour du texte lève TypeError. True a pour type exact bool mais satisfait le test int. Un tuple ou une union de types indique des alternatives. Le texte "1" n’est ni int ni float et n’est pas converti.

Les classes abstraites peuvent reconnaître des sous-classes virtuelles.

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

Exemples

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

Résultat

True
False

Les classes abstraites peuvent reconnaître des sous-classes virtuelles.

Sources