Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

functools.total_ordering

Doplní chybějící uspořádávací porovnání například z `__lt__` a odpovídající rovnosti `__eq__`.

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

Syntaxe

@functools.total_ordering

Doplní chybějící uspořádávací porovnání například z __lt__ a odpovídající rovnosti __eq__.

Vygenerovaná metoda volá existující porovnání. Proti přímé implementaci všech šesti metod přidává další volání a prodlužuje zásobník. Existující metody včetně zděděných zachová. NotImplemented pro cizí typ dovolí obrácené porovnání nebo TypeError.

Stejné úrovně splní >= a úroveň 1 nepřevýší 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

Příklady

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

Výsledek

True False

Stejné úrovně splní >= a úroveň 1 nepřevýší 3.

Zdroje