CKTIS / Python
Unija tipov X | None in anotacije s sklici naprej
Z zapisom `X | None` dovoliš vrednost tipa `X` ali `None`. Če je razred definiran pozneje, zapiši celotno anotacijo v narekovajih ali uporabi uvoz iz `__future__`.
Različica: 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: ...V Pythonu 3.12 zapis X | None dovoli vrednost tipa X ali None. Ta zapis je na voljo od Pythona 3.10 in je enakovreden zapisoma typing.Optional[X] in typing.Union[X, None], ne pa klicu typing.Union(...). Operator | tu običajno sestavi unijo tipov in ne izvede bitnega ALI nad celimi števili; metarazred z lastno metodo __or__ lahko spremeni rezultat. Anotacija med izvajanjem ne uveljavlja tipa in ne omogoča izpustitve argumenta brez privzete vrednosti.
Brez uvoza iz __future__ Python 3.12 ovrednoti običajne anotacije funkcije ob njeni definiciji. Če User še ni definiran, izraz User | None sproži NameError. Celotno unijo zapiši v narekovajih: "User|None". Če se "User" | None ovrednoti takoj, sproži TypeError. Podobno se "Ticket" in "Board" v podpisu funkcije sklicujeta na pozneje definirana razreda, ne na vrednosti tipa str.
Namesto tega lahko na začetek modula dodaš from __future__ import annotations in v anotacijah pišeš User | None, Ticket in Board brez narekovajev. Python 3.12 nato anotacije shrani kot nize. Ta uvoz ne odloži ovrednotenja običajne prireditve, kot je Alias = User | None.
Ko so razredi definirani, lahko typing.get_type_hints() razreši sklice iz __annotations__. Imena morajo biti takrat na voljo v ustreznem imenskem prostoru; po potrebi podaj globalns ali localns. Manjkajoče ime lahko sproži NameError. Ovrednotenje anotacij lahko izvede poljubno kodo, zato ne razrešuj anotacij iz nezaupanja vrednih virov.
Primeri
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
Prva vrstica prikaže izvirni niz `User|None`. Druga potrdi, da se unija razreši, tretja pa, da se razrešita oba sklica na razreda. Četrta pokaže, da koda ustvari `Ticket` z vrednostjo `None` za lastnika.
Povezane lekcije
- Python · Lekcija 1 · Napredna · Različica: 5