Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

W 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

Źródła