WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

functools.singledispatch

Wählt die Implementierung nach dem Typ des ersten Positionsarguments.

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

Syntax

@functools.singledispatch

Wählt die Implementierung nach dem Typ des ersten Positionsarguments.

Seit 3.11 registriert die Annotation int | float bei register dieselbe Funktion für int und float. dispatch(int) und dispatch(float) liefern dasselbe Objekt. register nimmt den Typ direkt oder aus einer Annotation, das Original dient für object. Oberklassen und registrierte abstrakte Basisklassen zählen mit. bool benutzt int, daher ergibt True integer und die Zeichenkette 3 other.

dispatch(type) zeigt die gewählte Funktion.

from functools import singledispatch
@singledispatch
def label(x): return "object"
@label.register(int)
def integer(x): return "int"
assert label(True) == "int" and label("1") == "object"
assert label.dispatch(bool) is integer and label.registry[int] is integer
@label.register
def numeric(x: int | float): return "number"
assert label.dispatch(int) is label.registry[float] is numeric
assert label(2) == label(2.5) == "number"

Beispiele

import functools
@functools.singledispatch
def describe(value): return "other"
@describe.register(int)
def number(value): return "integer"

print(describe(True), describe("3"))

Ergebnis

integer other

dispatch(type) zeigt die gewählte Funktion.

Quellen