Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

dataclasses.dataclass

Z anotácií polí predvolene vytvorí inicializátor, reprezentáciu a porovnanie hodnôt.

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

Syntax

@dataclasses.dataclass(frozen=True)

Z anotácií polí predvolene vytvorí inicializátor, reprezentáciu a porovnanie hodnôt.

Vytvorená metóda nezaručuje hašovateľné hodnoty polí. hash pre Item([]) vyvolá TypeError pre zoznam zahrnutý do výpočtu. Bez vlastného __hash__ vytvorí eq=True s frozen=True hašovaciu metódu, meniteľná trieda s eq=True nie je hašovateľná a eq=False zachová zdedené pravidlo. unsafe_hash=True vynúti vytvorenie metódy. slots=True vráti novú triedu. Polia predkov sa zbierajú v obrátenom MRO a prepísané pole si zachová pozíciu. Vytvorená rovnosť porovnáva vybrané polia inštancií presne tej istej triedy. Dva objekty Point(4) sú teda hodnotou rovnaké.

Pri frozen=True priradenie p.x vyvolá FrozenInstanceError, ale zoznam uložený v zamrznutom poli možno meniť.

from dataclasses import dataclass, FrozenInstanceError
@dataclass(frozen=True)
class Item:
    tags: list
x = Item([])
x.tags.append("ok")
assert x == Item(["ok"])
try:
    x.tags = []
except FrozenInstanceError:
    pass
else:
    raise AssertionError
class C: pass
assert dataclass(slots=True)(C) is not C
assert dataclass()(type("A", (), {})).__hash__ is None
assert callable(dataclass(frozen=True)(type("B", (), {})).__hash__)
try:
    hash(Item([]))
except TypeError:
    pass
else:
    raise AssertionError

Príklady

import dataclasses
@dataclasses.dataclass(frozen=True)
class Point:
    x: int

p = Point(4)
print(p == Point(4))
try:
    p.x = 9
except dataclasses.FrozenInstanceError as error:
    print(type(error).__name__)

Výsledok

True
FrozenInstanceError

Pri frozen=True priradenie p.x vyvolá FrozenInstanceError, ale zoznam uložený v zamrznutom poli možno meniť.

Zdroje