Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

Unija tipova X | None i anotacije s referencama unaprijed

Zapisom `X | None` dopuštaš vrijednost tipa `X` ili `None`. Ako je klasa definirana kasnije, stavi cijelu anotaciju u navodnike ili upotrijebi uvoz iz `__future__`.

Verzija: Python 3.12

Sintaksa

# Without the future import
class X: ...

value: X | None
value: "X | None"
def make_board(ticket: "Ticket") -> "Board": ...

# Alternative in Python 3.12: copy the next three lines without
# their comment prefixes into a separate module, with the import first.
# from __future__ import annotations
# value: X | None
# def make_board(ticket: Ticket) -> Board: ...

U Pythonu 3.12 zapis X | None dopušta vrijednost tipa X ili None. Ta je sintaksa dostupna od Pythona 3.10 i ekvivalentna je zapisima typing.Optional[X] i typing.Union[X, None], a ne pozivu typing.Union(...). Operator | ovdje obično gradi uniju tipova, a ne izvodi bitovni ILI nad cijelim brojevima; metaklasa s vlastitom metodom __or__ može promijeniti rezultat. Anotacija ne provjerava tip pri izvođenju niti dopušta izostavljanje argumenta bez zadane vrijednosti.

Bez uvoza iz __future__ Python 3.12 evaluira obične anotacije funkcije pri njezinu definiranju. Ako klasa User još nije definirana, User | None izaziva NameError. Stavi cijelu uniju u navodnike: "User|None". Ako se odmah evaluira, "User" | None izaziva TypeError. Isto tako, "Ticket" i "Board" u potpisu funkcije upućuju na klase definirane kasnije, a ne na vrijednosti tipa str.

Umjesto toga na početak modula možeš staviti from __future__ import annotations i u anotacijama pisati User | None, Ticket i Board bez navodnika. Python 3.12 tada pohranjuje anotacije kao nizove znakova. Taj uvoz ne odgađa evaluaciju obične dodjele poput Alias = User | None.

Kad su klase definirane, typing.get_type_hints() može razriješiti reference iz __annotations__. Imena tada moraju biti dostupna u odgovarajućem imenskom prostoru; po potrebi proslijedi globalns ili localns. Ako ime nedostaje, može doći do iznimke NameError. Evaluacija anotacija može izvršiti proizvoljan kod, pa ne razrješavaj anotacije iz nepouzdanih izvora.

Primjeri

from typing import get_type_hints


def make_board(ticket: "Ticket") -> "Board":
    return Board(ticket)


class Ticket:
    def __init__(self, owner: "User|None") -> None:
        self.owner = owner


class Board:
    def __init__(self, ticket: Ticket) -> None:
        self.ticket = ticket


class User:
    pass


print(Ticket.__init__.__annotations__["owner"])
print(get_type_hints(Ticket.__init__)["owner"] == (User | None))
board_hints = get_type_hints(make_board)
print(board_hints["ticket"] is Ticket, board_hints["return"] is Board)
print(make_board(Ticket(None)).ticket.owner is None)

Rezultat

User|None
True
True True
True

Prvi redak prikazuje izvorni niz `User|None`. Drugi potvrđuje da je unija razriješena, a treći da su obje reference na klase razriješene. Četvrti pokazuje da kod stvara `Ticket` čiji je vlasnik `None`.

Povezane lekcije

  • Python · Lekcija 1 · Napredno · Verzija: 5

Izvori