CKTIS / Python
dataclasses.field
Legt die Optionen eines annotierten Feldes fest.
Version: Python 3.14; repository image, production runtime not attested
Syntax
dataclasses.field(default_factory=list)Legt die Optionen eines annotierten Feldes fest.
MISSING steht für eine fehlende Angabe, None ist ein möglicher Vorgabewert. metadata ist eine schreibgeschützte Abbildung. Die Fabrik läuft für dieses Feld einmal je Instanz, die den Vorgabewert benötigt. Wird ein Vorgabewert benötigt, läuft default_factory ohne Argumente, daher wird list selbst übergeben. default und default_factory zusammen lösen ValueError aus. Jeder Bag erhält eine eigene Liste und Einfügen von 8 in a lässt b leer.
Seit 3.14 dokumentiert doc das Feld.
from dataclasses import dataclass, field
@dataclass
class Queue:
values: list = field(default_factory=list, repr=False)
a, b = Queue(), Queue()
assert a.values is not b.values and repr(a) == "Queue()"
try:
field(default=[], default_factory=list)
except ValueError:
pass
else:
raise AssertionError
from dataclasses import MISSING, fields
assert fields(Queue)[0].default is MISSING
explicit = []
assert Queue(explicit).values is explicit
Beispiele
import dataclasses
@dataclasses.dataclass
class Bag:
items: list = dataclasses.field(default_factory=list)
a, b = Bag(), Bag()
a.items.append(8)
print(a.items, b.items)
Ergebnis
[8] []
Seit 3.14 dokumentiert doc das Feld.