Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.singledispatch

Choisit 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.

Sources