KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

typing.TypeGuard

Annoteert een booleaans predicaat dat bij succes het statische type van het eerste positionele argument vernauwt, ook bij invariante lijsten.

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

Syntax

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

Annoteert een booleaans predicaat dat bij succes het statische type van het eerste positionele argument vernauwt, ook bij invariante lijsten.

Een onwaar resultaat bepaalt geen complementair type en Python controleert de belofte niet.

De test van alle elementen slaagt ook voor de lege lijst.

Voorbeelden

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

Resultaat

'' x,y mixed

De test van alle elementen slaagt ook voor de lege lijst.

Bronnen