WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Typvereinigungen: X | Y und X | None

In Typannotationen bezeichnet die Vereinigung X | Y einen Wert vom Typ X oder Y, während die Vereinigung X | None auch None zulässt. Annotationen beschreiben zulässige Werte, erzwingen aber nicht automatisch Laufzeitprüfungen.

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

Syntax

X | Y
X | None

Beim Standardverhalten von | bildet X | Y eine Typvereinigung, die typing.Union[X, Y] entspricht: Ein Wert kann vom Typ X oder Y sein. Zur Laufzeit kann eine benutzerdefinierte Metaklasse jedoch __or__ überschreiben. Auch wenn beide Operanden Typen sind, kann X | Y dann etwas anderes als eine Vereinigung zurückgeben und ist in diesem Fall nicht mit typing.Union[X, Y] gleichwertig. Es lassen sich weitere Typen kombinieren, zum Beispiel int | str | None. Hier verbindet | Typen und keine booleschen Werte. Die Syntax ist ab Python 3.10 verfügbar; in Python 3.14 sind Vereinigungsobjekte Instanzen von typing.Union, und types.UnionType ist ein Alias für diese Klasse.

Als Typvereinigung bezeichnet X | None einen Wert vom Typ X oder den Wert None und entspricht typing.Optional[X]. Das bedeutet nicht, dass ein Argument ausgelassen werden kann: Nur ein Standardwert, etwa value: int | None = None, ermöglicht das Weglassen beim Aufruf. Annotationen prüfen oder konvertieren Argumente zur Laufzeit nicht automatisch; der Code muss None selbst behandeln.

Die Reihenfolge der Elemente beeinflusst die Gleichheit der Vereinigung nicht, und Duplikate werden entfernt: int | str == str | int und int | str | int == int | str. Vereinigungen können mit isinstance() und issubclass() verwendet werden, parametrisierte Typen wie list[int] eignen sich jedoch nicht für solche Prüfungen. Die Prüfung isinstance([1], int | list[int]) löst TypeError aus.

Bei der Laufzeitauswertung eines Vereinigungsausdrucks darf ein Typ nicht mit einem als Zeichenkette geschriebenen Verweis auf eine Klasse kombiniert werden: int | "Foo" schlägt fehl. Wird ein solcher Verweis in einer Annotation benötigt, muss der gesamte Ausdruck in Anführungszeichen stehen: "int | Foo". Im Beispiel behandelt describe None ausdrücklich und wandelt anschließend die übrigen Werte in Text um.

In diesem Eintrag behandelte Referenzbezeichner: X | None / X | Y type union.

Beispiele

def describe(value: int | str | None) -> str:
    if value is None:
        return "missing"
    return str(value)

print(describe(7))
print(describe("hello"))
print(describe(None))
print(isinstance("hello", int | str))

Ergebnis

7
hello
missing
True

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen