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

CKTIS / Python

functools.total_ordering

Complète les comparaisons d’ordre manquantes à partir par exemple de `__lt__` et d’une égalité `__eq__` cohérente.

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

Syntaxe

@functools.total_ordering

Complète les comparaisons d’ordre manquantes à partir par exemple de __lt__ et d’une égalité __eq__ cohérente.

Une méthode générée appelle les comparaisons existantes. Par rapport à six méthodes écrites directement, elle ajoute des appels et allonge la pile. Les méthodes existantes, même héritées, sont conservées. NotImplemented pour un type étranger autorise un essai réfléchi ou TypeError.

Les rangs égaux vérifient >= et le rang 1 ne dépasse pas 3.

from functools import total_ordering
@total_ordering
class Level:
    def __init__(self, n): self.n = n
    def __eq__(self, other): return self.n == other.n if isinstance(other, Level) else NotImplemented
    def __lt__(self, other): return self.n < other.n if isinstance(other, Level) else NotImplemented
assert Level(2) >= Level(2) and Level(3) > Level(2)
try:
    Level(1) < 2
except TypeError:
    pass
else:
    raise AssertionError
assert Level.__lt__(Level(2), "x") is NotImplemented

Exemples

import functools
@functools.total_ordering
class Rank:
    def __init__(self, value): self.value = value
    def __eq__(self, other): return self.value == other.value if isinstance(other, Rank) else NotImplemented
    def __lt__(self, other): return self.value < other.value if isinstance(other, Rank) else NotImplemented

print(Rank(2) >= Rank(2), Rank(1) > Rank(3))

Résultat

True False

Les rangs égaux vérifient >= et le rang 1 ne dépasse pas 3.

Sources