Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Python

Anotacije referenci unaprijed u navodnicima

Anotacija poput "Node" opisuje tip pomoću naziva pohranjenog kao tekst, čak i kada se klasa definira kasnije. Python 3.14 prema zadanim postavkama odgađa evaluaciju anotacija, pa navodnici često više nisu potrebni, ali ostaju valjana sintaksa.

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

Sintaksa

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

Anotacije referenci unaprijed u navodnicima (quoted forward-reference annotations) upotrebljavaju znakovni literal kao naznaku tipa, primjerice node: "Node" ili -> "Node". Omogućuju referenciranje klase definirane kasnije, uključujući klasu koja referencira samu sebe. To ne znači da je očekivana vrijednost tipa str.

U Pythonu 3.14 evaluacija anotacija prema zadanim se postavkama odgađa, pa je za ovu vrstu reference obično dovoljan i Node bez navodnika. Izričiti zapis "Node" ostaje valjan. To se razlikuje od from __future__ import annotations, zbog kojeg se anotacije pohranjuju kao nizovi znakova. Same naznake tipova ne nameću tipove argumenata tijekom izvođenja.

typing.get_type_hints() razrješava tekstualne reference u stvarne tipove. Pozovite je tek kada su potrebni nazivi dostupni u odgovarajućim imenskim prostorima; nerazriješeni naziv može uzrokovati NameError. Funkcija može izvršiti kod sadržan u anotacijama, stoga je nemojte upotrebljavati s anotacijama kojima ne vjerujete.

U primjeru se identity pojavljuje prije definicije Node, ali se naznake tipova pregledavaju nakon nje. Dva rezultata True prikazuju očekivano razrješenje obiju anotacija u klasu Node, a posljednji redak prikazuje naziv klase vraćenog objekta.

Primjeri

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__)

Rezultat

True
True
Node

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori