WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

functools.total_ordering

Ergänzt fehlende Ordnungsvergleiche aus etwa `__lt__` und einer passenden Gleichheit `__eq__`.

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

Syntax

@functools.total_ordering

Ergänzt fehlende Ordnungsvergleiche aus etwa __lt__ und einer passenden Gleichheit __eq__.

Eine erzeugte Methode ruft vorhandene Vergleiche auf. Gegenüber sechs direkt implementierten Methoden entstehen zusätzliche Aufrufe und längere Aufrufstapel. Vorhandene, auch geerbte Methoden bleiben erhalten. NotImplemented für fremde Typen erlaubt gespiegelten Vergleich oder TypeError.

Gleiche Ränge erfüllen >= und Rang 1 übersteigt 3 nicht.

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

Beispiele

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))

Ergebnis

True False

Gleiche Ränge erfüllen >= und Rang 1 übersteigt 3 nicht.

Quellen