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

CKTIS / Python

typing.TypeGuard

Anota um predicado booleano cujo sucesso restringe o tipo estático do primeiro argumento posicional mesmo para listas invariantes.

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

Sintaxe

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

Anota um predicado booleano cujo sucesso restringe o tipo estático do primeiro argumento posicional mesmo para listas invariantes.

Um resultado falso não determina um tipo complementar e o Python não valida a promessa.

A verificação de todos os elementos também aceita a lista vazia.

Exemplos

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

A verificação de todos os elementos também aceita a lista vazia.

Fontes