Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri