Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Anotace dopředných odkazů v uvozovkách

Anotace jako "Node" popisuje typ pomocí názvu uloženého jako text, i když je třída definována až později. Python 3.14 ve výchozím nastavení odkládá vyhodnocení anotací, takže uvozovky často už nejsou potřeba, ale zůstávají platným zápisem.

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

Syntaxe

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

Anotace dopředných odkazů v uvozovkách (quoted forward-reference annotations) používají řetězcový literál jako typovou nápovědu, například node: "Node" nebo -> "Node". Umožňují odkazovat na třídu definovanou později, včetně třídy, která odkazuje sama na sebe. Neznamenají, že očekávaná hodnota má typ str.

V Pythonu 3.14 se vyhodnocení anotací ve výchozím nastavení odkládá, takže pro tento druh odkazu obvykle stačí i Node bez uvozovek. Výslovný zápis "Node" zůstává platný. To se liší od from __future__ import annotations, které způsobí ukládání anotací jako řetězců. Samotné typové nápovědy za běhu nevynucují typy argumentů.

typing.get_type_hints() převádí textové odkazy na skutečné typy. Zavolejte ji až ve chvíli, kdy jsou potřebné názvy dostupné v příslušných jmenných prostorech; nevyřešený název může způsobit NameError. Funkce může spouštět kód obsažený v anotacích, proto ji nepoužívejte u nedůvěryhodných anotací.

V příkladu se identity objevuje před definicí Node, ale typové nápovědy se zkoumají až poté. Dva výsledky True ukazují očekávané vyřešení obou anotací na třídu Node a poslední řádek uvádí název třídy vráceného objektu.

Pří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ýsledek

True
True
Node

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje