KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Het unietype `X | None`

`X | None` beschrijft een waarde van het type `X` of de waarde `None`. In `-> str | None` gaat het om de retourwaarde van een functie, niet om een standaardwaarde.

Versie: Python 3.12

Syntax

X | None

In Python 3.12 combineert X | None het type X met het type waarvan None de enige waarde is. Deze schrijfwijze bestaat sinds Python 3.10. In str | None vormt | een unietype; het voert geen bitsgewijze OF-bewerking op gehele getallen uit. Als typeannotatie is X | None gelijkwaardig aan typing.Optional[X] en typing.Union[X, None].

Met de parameterannotatie value: str | None mag je None doorgeven, maar je mag het argument niet weglaten: er is geen standaardwaarde opgegeven. Met value: str | None = None geef je ook een standaardwaarde op. Python controleert deze annotaties zelf niet tijdens de uitvoering.

In het voorbeeld beschrijft -> str | None de retourwaarde van de hulpfunctie parse_args. De methode argparse.ArgumentParser.parse_args retourneert een argparse.Namespace, terwijl de hulpfunctie alleen het attribuut profile daarvan retourneert. Controleer profile is None voordat je stringmethoden gebruikt: '' is nog steeds een string en geen ontbrekende waarde.

Voorbeelden

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

Resultaat

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

De drie aanroepen tonen een weggelaten optie `--profile`, de waarde `'dev'` en een expliciet doorgegeven lege string `''`.

Gerelateerde lessen

  • Python · Les 34 · Gevorderd · Versie: 5

Bronnen