База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

Анотации на препратки напред в кавички

Анотация като "Node" описва тип чрез име, съхранено като текст, дори когато класът е дефиниран по-късно. Python 3.14 отлага оценяването на анотациите по подразбиране, затова кавичките често вече не са необходими, но остават валиден синтаксис.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

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

Анотациите на препратки напред в кавички (quoted forward-reference annotations) използват низов литерал като указание за тип, например node: "Node" или -> "Node". Те позволяват препращане към клас, дефиниран по-късно, включително към клас, който препраща към себе си. Това не означава, че очакваната стойност е от тип str.

В Python 3.14 оценяването на анотациите се отлага по подразбиране, така че за този вид препратка обикновено е достатъчно и Node без кавички. Изричният запис "Node" остава валиден. Това е различно от from __future__ import annotations, което кара анотациите да се съхраняват като низове. Самите указания за тип не налагат типовете на аргументите по време на изпълнение.

typing.get_type_hints() разрешава текстовите препратки до действителни типове. Извикайте я само когато необходимите имена са налични в съответните пространства от имена; неразрешено име може да доведе до NameError. Функцията може да изпълнява код, съдържащ се в анотациите, затова не я използвайте с анотации, на които нямате доверие.

В примера identity се появява преди дефиницията на Node, но указанията за тип се разглеждат след нея. Двата резултата True показват очакваното разрешаване на двете анотации до класа Node, а последният ред показва името на класа на върнатия обект.

Примери

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

Резултат

True
True
Node

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници