CKTIS / Python
functools.total_ordering
Vult ontbrekende ordeningsvergelijkingen aan uit bijvoorbeeld `__lt__` en een samenhangende gelijkheid `__eq__`.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
@functools.total_orderingVult ontbrekende ordeningsvergelijkingen aan uit bijvoorbeeld __lt__ en een samenhangende gelijkheid __eq__.
Een gegenereerde methode roept bestaande vergelijkingen aan. Dat kost extra aanroepen en geeft een langere aanroepstack dan zes rechtstreeks geïmplementeerde methoden. Bestaande methoden, ook geërfde, blijven behouden. NotImplemented voor een vreemd type laat een omgekeerde vergelijking of TypeError toe.
Gelijke rangen voldoen aan >= en rang 1 is niet groter dan 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
Voorbeelden
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))
Resultaat
True False
Gelijke rangen voldoen aan >= en rang 1 is niet groter dan 3.