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.singledispatchWä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.