WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

typing.TypeGuard

Kennzeichnet ein boolesches Prädikat, dessen positives Ergebnis den ersten Positionsparameter statisch verengt, auch bei invarianten Listen.

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

Syntax

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

Kennzeichnet ein boolesches Prädikat, dessen positives Ergebnis den ersten Positionsparameter statisch verengt, auch bei invarianten Listen.

Ein negatives Ergebnis bestimmt keinen Komplementtyp und Python prüft das Versprechen nicht.

Der Test jedes Elements gelingt daher auch für die leere Liste.

Beispiele

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

Ergebnis

'' x,y mixed

Der Test jedes Elements gelingt daher auch für die leere Liste.

Quellen