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

CKTIS / Python

typing.TypeGuard

Annote un prédicat booléen dont le succès affine statiquement le premier argument positionnel, même pour une liste invariante.

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

Syntaxe

def is_names(value: list[object]) -> TypeGuard[list[str]]: ...

Annote un prédicat booléen dont le succès affine statiquement le premier argument positionnel, même pour une liste invariante.

Un échec ne détermine aucun type complémentaire et Python ne valide pas la promesse.

Le test de chaque élément réussit aussi sur la liste vide.

Exemples

from typing import TypeGuard
def is_names(value: list[object]) -> TypeGuard[list[str]]:
    return all(isinstance(x, str) for x in value)
def join(values: list[object]) -> str:
    return ",".join(values) if is_names(values) else "mixed"
print(repr(join([])), join(["x", "y"]), join(["x", 2]))

Résultat

'' x,y mixed

Le test de chaque élément réussit aussi sur la liste vide.

Sources