Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

typing.TypeGuard

Anota un predicado booleano cuyo éxito estrecha el tipo estático del primer argumento posicional, incluso en listas invariantes.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

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

Anota un predicado booleano cuyo éxito estrecha el tipo estático del primer argumento posicional, incluso en listas invariantes.

El resultado falso no determina un tipo complementario y Python no valida la promesa.

La comprobación de todos los elementos también acepta la lista vacía.

Ejemplos

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

Resultado

'' x,y mixed

La comprobación de todos los elementos también acepta la lista vacía.

Fuentes