KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

De literal `...` (`Ellipsis`) in protocolmethoden

In Python 3.12 is `...` een literal voor het object `Ellipsis`. In de body van een protocolmethode geeft die aan dat er geen implementatie is, maar retourneert die het object niet.

Versie: Python 3.12

Syntax

...

from typing import Protocol

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

De drie opeenvolgende punten ... vormen een token in de Python-syntaxis, geen redactionele aanduiding voor weggelaten code. De literal levert de enige instantie van types.EllipsisType op. Die is ook bereikbaar via de ingebouwde naam Ellipsis. Met is controleer je of het om hetzelfde object gaat.

Als ... het enige statement in de body van een gewone functie is, wordt het gebruikt als expressiestatement: de waarde wordt niet geretourneerd. Aan het einde van de body retourneert de functie None, net als bij alleen pass. Maar pass is een statement, geen expressie. return ... retourneert juist expliciet Ellipsis.

In een klasse op basis van typing.Protocol geeft een body met alleen ... aan dat de methode een eis aan de interface stelt in plaats van een bruikbare standaardimplementatie te bieden. Een statische typechecker kan een klasse met een compatibele methodehandtekening accepteren, ook als die klasse niet van het protocol erft. De literal past zelf geen @abstractmethod toe en activeert tijdens de uitvoering geen controle van methodehandtekeningen.

Voorbeelden

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

Resultaat

True
True
7

De eerste `True` bevestigt de identiteit met `Ellipsis`; de tweede laat zien dat `placeholder()` `None` retourneert. De `7` komt uit `FixedReader.read()`, niet uit de body van de protocolmethode.

Gerelateerde lessen

  • Python · Les 22 · Gevorderd · Versie: 5

Bronnen