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

CKTIS / Python

Tipske anotacije s sklici naprej v narekovajih

Tipska anotacija, kot je `"Node"`, označuje tip z imenom, zapisanim kot niz, tudi če je razred definiran šele pozneje. Python 3.14 privzeto odloži vrednotenje anotacij, zato narekovaji pogosto niso več potrebni, vendar je zapis z njimi še vedno veljaven.

Različica: Python 3.14; repository image, production runtime not attested

Sintaksa

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

Tipske anotacije s sklici naprej v narekovajih (quoted forward-reference annotations) uporabljajo nizovni literal kot namig za tip, na primer node: "Node" ali -> "Node". Tako se lahko sklicujemo na razred, definiran pozneje, ali pa se razred sklicuje sam nase. Narekovaji ne pomenijo, da mora biti pričakovana vrednost tipa str.

V Pythonu 3.14 je vrednotenje anotacij privzeto odloženo, zato za tak sklic običajno zadostuje tudi Node brez narekovajev. Izrecni zapis "Node" ostaja veljaven. Odloženo vrednotenje ni isto kot from __future__ import annotations, pri katerem se anotacije shranijo kot nizi. Namigi za tipe sami po sebi med izvajanjem ne uveljavljajo tipov argumentov.

typing.get_type_hints() razreši sklice, zapisane kot nizi, v dejanske tipe. Funkcijo pokličite šele, ko so potrebna imena na voljo v ustreznih imenskih prostorih. Če imena ni mogoče razrešiti, lahko pride do napake NameError. Funkcija lahko izvede kodo iz anotacij, zato je ne uporabljajte za anotacije, ki jim ne zaupate.

V primeru je identity definirana pred razredom Node, namige za tipe pa preberemo šele po definiciji razreda. Izpisa True pokažeta, da se obe anotaciji po pričakovanjih razrešita v razred Node, zadnja vrstica pa izpiše ime razreda vrnjenega objekta.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju po metodi, dokumentirani v dokazilu o preverjanju prav te različice.

Viri