Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

Unije tipova: X | Y i X | None

U anotacijama tipova unija X | Y označava vrijednost tipa X ili Y, dok unija X | None dopušta i None. Anotacije opisuju dopuštene vrijednosti, ali ne provode automatske provjere tijekom izvođenja.

Verzija: Python 3.14; repository image, production runtime not attested

Sintaksa

X | Y
X | None

Pri standardnom ponašanju operatora | izraz X | Y stvara uniju tipova ekvivalentnu zapisu typing.Union[X, Y]: vrijednost može biti tipa X ili Y. Međutim, prilagođena metaklasa tijekom izvođenja može redefinirati metodu __or__. Čak i ako su oba operanda tipovi, X | Y tada može vratiti nešto drugo umjesto unije i u tom slučaju nije ekvivalentan zapisu typing.Union[X, Y]. Moguće je kombinirati više tipova, primjerice int | str | None. Ovdje | povezuje tipove, a ne Booleove vrijednosti. Sintaksa je dostupna od Pythona 3.10; u Pythonu 3.14 objekti unije instance su klase typing.Union, a types.UnionType alias je te klase.

Kao unija tipova, izraz X | None označava vrijednost tipa X ili vrijednost None i ekvivalentan je zapisu typing.Optional[X]. To ne znači da se argument može izostaviti: izostavljanje pri pozivu omogućuje tek zadana vrijednost, primjerice value: int | None = None. Anotacije tijekom izvođenja ne provjeravaju niti pretvaraju argumente automatski; kod mora sam obraditi None.

Redoslijed članova ne utječe na jednakost unije, a duplikati se uklanjaju: int | str == str | int i int | str | int == int | str. Unije se mogu upotrebljavati s isinstance() i issubclass(), ali parametrizirani tipovi poput list[int] nisu prikladni za takve provjere. Provjera isinstance([1], int | list[int]) izaziva TypeError.

Pri izračunavanju izraza unije tijekom izvođenja nemojte kombinirati tip s tekstualnom referencom na klasu: int | "Foo" ne uspijeva. Ako anotacija treba takvu referencu, stavite cijeli izraz u navodnike: "int | Foo". U primjeru describe izričito obrađuje None, a zatim pretvara preostale vrijednosti u tekst.

Referentni identifikatori obuhvaćeni ovim unosom: X | None / X | Y type union.

Primjeri

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

Rezultat

7
hello
missing
True

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori