Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

dataclasses.field

Określa ustawienia pojedynczego pola z adnotacją.

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

Składnia

dataclasses.field(default_factory=list)

Określa ustawienia pojedynczego pola z adnotacją.

MISSING oznacza brak ustawienia, None jest dozwoloną wartością domyślną. metadata to odwzorowanie tylko do odczytu. Fabryka działa raz dla danego pola w każdej instancji, która korzysta z wartości domyślnej. Gdy potrzebna jest wartość domyślna, default_factory wywołuje fabrykę bez argumentów, dlatego przekazuje się list, a nie list(). Jednoczesne default i default_factory zgłaszają ValueError. Każdy Bag otrzymuje osobną listę, więc dodanie 8 do a nie zmienia b.

Od 3.14 doc opisuje pole.

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

Przykłady

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)

Wynik

[8] []

Od 3.14 doc opisuje pole.

Źródła