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 | NoneIn 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