CKTIS / Python
functools.singledispatch
Kiest de implementatie op het type van het eerste positieargument.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
@functools.singledispatchKiest de implementatie op het type van het eerste positieargument.
Sinds 3.11 schrijft register met de annotatie int | float dezelfde functie in voor int en float. dispatch(int) en dispatch(float) geven hetzelfde object. register accepteert het type expliciet of afgeleid uit een annotatie, het origineel behandelt object. Ook bovenklassen en geregistreerde abstracte basisklassen tellen mee. bool gebruikt int, dus True geeft integer en de tekenreeks 3 geeft other.
dispatch(type) toont de gekozen functie.
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"
Voorbeelden
import functools
@functools.singledispatch
def describe(value): return "other"
@describe.register(int)
def number(value): return "integer"
print(describe(True), describe("3"))
Resultaat
integer other
dispatch(type) toont de gekozen functie.