WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Annotations mit Zeichenketten für Vorwärtsreferenzen

Eine Annotation wie "Node" bezeichnet einen Typ anhand eines als Text gespeicherten Namens, auch wenn die Klasse erst später definiert wird. Python 3.14 wertet Annotationen standardmäßig verzögert aus; Anführungszeichen sind daher oft nicht mehr nötig, bleiben aber gültige Syntax.

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

Syntax

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

Annotations mit Zeichenketten für Vorwärtsreferenzen (quoted forward-reference annotations) verwenden ein Stringliteral als Typhinweis, etwa node: "Node" oder -> "Node". Damit kann auf eine später definierte Klasse verwiesen werden, auch auf eine Klasse, die sich selbst referenziert. Das bedeutet nicht, dass der erwartete Wert den Typ str hat.

In Python 3.14 wird die Auswertung von Annotationen standardmäßig verzögert, sodass für diese Art von Referenz normalerweise auch ein nicht in Anführungszeichen gesetztes Node genügt. Explizites "Node" bleibt gültig. Das ist etwas anderes als from __future__ import annotations, wodurch Annotationen als Zeichenketten gespeichert werden. Typhinweise allein erzwingen zur Laufzeit keine Argumenttypen.

typing.get_type_hints() löst Zeichenkettenreferenzen in tatsächliche Typen auf. Rufe die Funktion erst auf, wenn die benötigten Namen in den entsprechenden Namensräumen verfügbar sind; ein nicht auflösbarer Name kann einen NameError verursachen. Die Funktion kann in Annotationen enthaltenen Code ausführen. Verwende sie daher nicht mit nicht vertrauenswürdigen Annotationen.

Im Beispiel steht identity vor der Definition von Node, die Typhinweise werden aber erst danach untersucht. Die beiden Ergebnisse True zeigen, dass beide Annotationen wie erwartet zur Klasse Node aufgelöst werden. Die letzte Zeile zeigt den Klassennamen des zurückgegebenen Objekts.

Beispiele

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

Ergebnis

True
True
Node

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen