Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Sjednocení typů `X | None`

`X | None` označuje hodnotu typu `X` nebo hodnotu `None`. V zápisu `-> str | None` popisuje návratovou hodnotu funkce, nikoli výchozí hodnotu.

Verze: Python 3.12

Syntaxe

X | None

V Pythonu 3.12 zápis X | None sjednocuje typ X s typem, jehož jedinou hodnotou je None. Tento zápis je k dispozici od Pythonu 3.10. V str | None operátor | vytváří sjednocení typů; neprovádí bitové OR nad celými čísly. Jako typová anotace je X | None ekvivalentní zápisům typing.Optional[X] a typing.Union[X, None].

Anotace parametru value: str | None umožňuje předat None, ale neumožňuje argument vynechat: není uvedena výchozí hodnota. Zápis value: str | None = None navíc nastavuje výchozí hodnotu. Python sám tyto anotace za běhu nekontroluje.

V příkladu -> str | None popisuje návratovou hodnotu pomocné funkce parse_args. Metoda argparse.ArgumentParser.parse_args vrací objekt argparse.Namespace, zatímco pomocná funkce vrací jen jeho atribut profile. Než použiješ metody řetězců, otestuj profile is None: '' je stále řetězec a neoznačuje chybějící hodnotu.

Příklady

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}")

Výsledek

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

Tři volání ukazují vynechanou volbu `--profile`, hodnotu `'dev'` a výslovně předaný prázdný řetězec `''`.

Související lekce

  • Python · Lekce 34 · Pokročilá · Verze: 5

Zdroje