CKTIS / Python
functools.singledispatch
Choisit l’implémentation selon le type du premier argument positionnel.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
@functools.singledispatchChoisit l’implémentation selon le type du premier argument positionnel.
Depuis la version 3.11, register accepte l’annotation int | float et inscrit la même fonction pour int et float. dispatch(int) et dispatch(float) renvoient le même objet. register prend un type explicite ou déduit de l’annotation, l’original traite object. Les classes parentes et bases abstraites enregistrées sont prises en compte. bool relève de int, donc True donne integer et la chaîne 3 donne other.
dispatch(type) révèle la fonction choisie.
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"
Exemples
import functools
@functools.singledispatch
def describe(value): return "other"
@describe.register(int)
def number(value): return "integer"
print(describe(True), describe("3"))
Résultat
integer other
dispatch(type) révèle la fonction choisie.