Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Literál `...` (`Ellipsis`) v metodách protokolu

V Pythonu 3.12 je `...` literál objektu `Ellipsis`. V těle metody protokolu označuje, že metoda neposkytuje implementaci, ale sám tento objekt nevrací.

Verze: Python 3.12

Syntaxe

...

from typing import Protocol

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

Tři po sobě jdoucí tečky ... jsou součástí syntaxe Pythonu, nikoli redakční značkou pro vynechaný kód. Literál se vyhodnotí na jedinou instanci typu types.EllipsisType, která je dostupná i pod vestavěným názvem Ellipsis. Operátorem is lze ověřit, že jde o tentýž objekt.

Je-li ... jediným příkazem v těle běžné funkce, jde o výraz použitý jako příkaz: jeho hodnota se nevrací. Po dosažení konce těla funkce vrátí None, stejně jako při použití samotného pass. pass je však příkaz, nikoli výraz. Naproti tomu return ... výslovně vrací Ellipsis.

Ve třídě založené na typing.Protocol tělo tvořené ... znamená, že metoda stanovuje požadavek rozhraní, místo aby poskytovala použitelnou výchozí implementaci. Nástroj pro statickou kontrolu typů může přijmout i třídu s kompatibilní signaturou metody, která od protokolu nedědí. Samotný literál nepoužije @abstractmethod ani nespouští kontrolu signatur za běhu.

Příklady

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

Výsledek

True
True
7

První `True` potvrzuje totožnost s objektem `Ellipsis`; druhé ukazuje, že `placeholder()` vrací `None`. Hodnota `7` pochází z `FixedReader.read()`, nikoli z těla metody protokolu.

Související lekce

  • Python · Lekce 22 · Pokročilá · Verze: 5

Zdroje