WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Der Unionstyp `X | None`

`X | None` beschreibt einen Wert vom Typ `X` oder den Wert `None`. In `-> str | None` bezeichnet die Union den Rückgabewert einer Funktion, keinen Standardwert.

Version: Python 3.12

Syntax

X | None

In Python 3.12 verbindet X | None den Typ X mit dem Typ, dessen einziger Wert None ist. Diese Schreibweise gibt es seit Python 3.10. In str | None bildet | einen Unionstyp; es führt kein bitweises Oder mit Ganzzahlen aus. Als Typangabe ist X | None gleichbedeutend mit typing.Optional[X] und typing.Union[X, None].

Mit der Parameterannotation value: str | None darf man None übergeben, das Argument aber nicht weglassen: Es ist kein Standardwert angegeben. value: str | None = None legt zusätzlich einen Standardwert fest. Python selbst prüft diese Annotationen zur Laufzeit nicht.

Im Beispiel beschreibt -> str | None den Rückgabewert der Hilfsfunktion parse_args. Die Methode argparse.ArgumentParser.parse_args gibt ein argparse.Namespace zurück, die Hilfsfunktion dagegen nur dessen Attribut profile. Prüfe vor der Verwendung von Zeichenkettenmethoden mit profile is None, ob der Wert fehlt: '' ist weiterhin eine Zeichenkette.

Beispiele

import argparse


def parse_args(argv: list[str]) -> str | None:
    parser = argparse.ArgumentParser()
    parser.add_argument("--profile", default=None)
    return parser.parse_args(argv).profile


for argv in ([], ["--profile", "dev"], ["--profile="]):
    profile = parse_args(argv)
    if profile is None:
        print("No profile provided")
    else:
        print(f"Profile: {profile!r}")

Ergebnis

No profile provided
Profile: 'dev'
Profile: ''

Die drei Aufrufe zeigen eine weggelassene Option `--profile`, den Wert `'dev'` und eine ausdrücklich übergebene leere Zeichenkette `''`.

Zugehörige Lektionen

  • Python · Lektion 34 · Fortgeschritten · Version: 5

Quellen