KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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_ordering

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

Bronnen