Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

Anotácie dopredných odkazov v úvodzovkách

Anotácia ako "Node" opisuje typ pomocou názvu uloženého ako text, aj keď sa trieda definuje až neskôr. Python 3.14 predvolene odkladá vyhodnocovanie anotácií, takže úvodzovky často už nie sú potrebné, ale zostávajú platným zápisom.

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

Syntax

def f(value: "LaterType") -> "LaterType": ...

Anotácie dopredných odkazov v úvodzovkách (quoted forward-reference annotations) používajú reťazcový literál ako typovú nápovedu, napríklad node: "Node" alebo -> "Node". Umožňujú odkazovať na triedu definovanú neskôr vrátane triedy, ktorá odkazuje sama na seba. Neznamenajú, že očakávaná hodnota má typ str.

V Pythone 3.14 sa vyhodnocovanie anotácií predvolene odkladá, takže pri tomto druhu odkazu zvyčajne stačí aj Node bez úvodzoviek. Výslovný zápis "Node" zostáva platný. To sa líši od from __future__ import annotations, ktoré spôsobuje ukladanie anotácií ako reťazcov. Samotné typové nápovedy za behu nevynucujú typy argumentov.

typing.get_type_hints() rieši textové odkazy na skutočné typy. Zavolajte ju až vtedy, keď sú potrebné názvy dostupné v príslušných menných priestoroch; nevyriešený názov môže spôsobiť NameError. Funkcia môže vykonávať kód obsiahnutý v anotáciách, preto ju nepoužívajte pri nedôveryhodných anotáciách.

V príklade sa identity nachádza pred definíciou Node, ale typové nápovedy sa skúmajú až po nej. Dva výsledky True ukazujú očakávané vyriešenie oboch anotácií na triedu Node a posledný riadok zobrazuje názov triedy vráteného objektu.

Príklady

from typing import get_type_hints


def identity(node: "Node") -> "Node":
    return node


class Node:
    pass


hints = get_type_hints(identity)
print(hints["node"] is Node)
print(hints["return"] is Node)
print(identity(Node()).__class__.__name__)

Výsledok

True
True
Node

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje