Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

typing.TypeGuard

Annota un predicato booleano il cui successo restringe il tipo statico del primo argomento posizionale anche per liste invarianti.

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

Sintassi

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

Annota un predicato booleano il cui successo restringe il tipo statico del primo argomento posizionale anche per liste invarianti.

Un risultato falso non determina un tipo complementare e Python non verifica la promessa.

Il controllo di tutti gli elementi accetta anche la lista vuota.

Esempi

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

Risultato

'' x,y mixed

Il controllo di tutti gli elementi accetta anche la lista vuota.

Fonti