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