WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Das Literal `...` (`Ellipsis`) in Protokollmethoden

In Python 3.12 ist `...` ein Literal für das Objekt `Ellipsis`. Im Rumpf einer Protokollmethode signalisiert es eine fehlende Implementierung, gibt dieses Objekt aber nicht zurück.

Version: Python 3.12

Syntax

...

from typing import Protocol

class Reader(Protocol):
    def read(self) -> int:
        ...

Die drei aufeinanderfolgenden Punkte ... sind ein Token der Python-Syntax und kein redaktionelles Zeichen für ausgelassenen Code. Das Literal ergibt die einzige Instanz von types.EllipsisType, die auch über den eingebauten Namen Ellipsis verfügbar ist. Mit is lässt sich die Objektidentität prüfen.

Steht in einer gewöhnlichen Funktion nur ..., handelt es sich um eine Ausdrucksanweisung: Ihr Wert wird nicht zurückgegeben. Beim Erreichen des Rumpfendes gibt die Funktion None zurück, genau wie bei einem alleinstehenden pass. pass ist jedoch eine Anweisung und kein Ausdruck. Dagegen gibt return ... ausdrücklich Ellipsis zurück.

In einer Klasse auf Basis von typing.Protocol zeigt ein Rumpf mit ... an, dass die Methode eine Anforderung der Schnittstelle beschreibt, statt eine nutzbare Standardimplementierung zu liefern. Eine statische Typprüfung kann eine Klasse mit kompatibler Methodensignatur auch ohne Vererbung vom Protokoll akzeptieren. Das Literal selbst wendet weder @abstractmethod an noch löst es eine Signaturprüfung zur Laufzeit aus.

Beispiele

from typing import Protocol


class Reader(Protocol):
    def read(self) -> int:
        ...


class FixedReader:
    def read(self) -> int:
        return 7


def read_value(reader: Reader) -> int:
    return reader.read()


def placeholder() -> None:
    ...


print((...) is Ellipsis)
print(placeholder() is None)
print(read_value(FixedReader()))

Ergebnis

True
True
7

Das erste `True` bestätigt die Identität mit `Ellipsis`; das zweite zeigt, dass `placeholder()` den Wert `None` zurückgibt. Die `7` stammt aus `FixedReader.read()`, nicht aus dem Rumpf der Protokollmethode.

Zugehörige Lektionen

  • Python · Lektion 22 · Fortgeschritten · Version: 5

Quellen