CKTIS / Python
Type-unies: X | Y en X | None
In typeannotaties staat de unie X | Y voor een waarde van type X of Y, terwijl de unie X | None ook None toestaat. Annotaties beschrijven toegestane waarden, maar dwingen tijdens de uitvoering niet automatisch controles af.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
X | Y
X | NoneBij het standaardgedrag van | levert X | Y een type-unie op die gelijkwaardig is aan typing.Union[X, Y]: een waarde kan van type X of Y zijn. Tijdens de uitvoering kan een aangepaste metaklasse __or__ echter overschrijven. Zelfs als beide operanden typen zijn, kan X | Y dan iets anders dan een unie opleveren. In dat geval is het niet gelijkwaardig aan typing.Union[X, Y]. Er kunnen meer typen worden gecombineerd, bijvoorbeeld int | str | None. Hier combineert | typen, geen booleaanse waarden. Deze syntaxis is beschikbaar vanaf Python 3.10; in Python 3.14 zijn unieobjecten instanties van typing.Union en is types.UnionType een alias voor die klasse.
Als type-unie staat X | None voor een waarde van type X of de waarde None en is deze gelijkwaardig aan typing.Optional[X]. Dit betekent niet dat een argument mag worden weggelaten: alleen een standaardwaarde, zoals value: int | None = None, maakt weglaten bij een aanroep mogelijk. Annotaties controleren of converteren argumenten tijdens de uitvoering niet automatisch; de code moet None zelf afhandelen.
De volgorde van de leden heeft geen invloed op de gelijkheid van unies en duplicaten worden verwijderd: int | str == str | int en int | str | int == int | str. Unies kunnen worden gebruikt met isinstance() en issubclass(), maar geparametriseerde typen zoals list[int] zijn niet geschikt voor zulke controles. De controle isinstance([1], int | list[int]) geeft TypeError.
Als je tijdens de uitvoering een unie-expressie evalueert, combineer dan geen type met een verwijzing naar een klasse in de vorm van een tekenreeks: int | "Foo" mislukt. Als een annotatie zo’n verwijzing nodig heeft, zet dan de hele expressie tussen aanhalingstekens: "int | Foo". In het voorbeeld handelt describe None expliciet af en zet daarna de overige waarden om in tekst.
Referentie-identificatoren die in dit item worden behandeld: X | None / X | Y type union.
Voorbeelden
def describe(value: int | str | None) -> str:
if value is None:
return "missing"
return str(value)
print(describe(7))
print(describe("hello"))
print(describe(None))
print(isinstance("hello", int | str))Resultaat
7 hello missing True
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.