CKTIS / Python
Unia typów `X | None`
Zapis `X | None` oznacza wartość typu `X` albo `None`. W adnotacji `-> str | None` opisuje wynik funkcji, a nie wartość domyślną.
Wersja: Python 3.12
Składnia
X | NoneW Pythonie 3.12 zapis X | None oznacza unię typu X i typu, którego jedyną wartością jest None. Ta składnia jest dostępna od Pythona 3.10. W str | None operator | tworzy unię typów; nie wykonuje bitowej alternatywy na liczbach. W adnotacji X | None jest równoważne typing.Optional[X] oraz typing.Union[X, None].
Adnotacja parametru value: str | None dopuszcza przekazanie None, ale nie pozwala pominąć argumentu: w tym zapisie nie ma wartości domyślnej. Zapis value: str | None = None dodatkowo ustawia wartość domyślną. Python sam nie sprawdza zgodności wartości z tymi adnotacjami podczas wykonywania programu.
W przykładzie -> str | None opisuje wynik funkcji pomocniczej parse_args. Metoda argparse.ArgumentParser.parse_args zwraca argparse.Namespace, a funkcja pomocnicza zwraca tylko jego atrybut profile. Sprawdź profile is None przed użyciem metod napisów: pusty napis '' nadal jest napisem i nie oznacza braku wartości.
Przykłady
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}")
Wynik
No profile provided Profile: 'dev' Profile: ''
Trzy wywołania pokazują brak opcji `--profile`, wartość `'dev'` oraz jawnie podany pusty napis `''`.
Powiązane lekcje
- Python · Lekcja 34 · Zaawansowany · Wersja: 5