Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

dataclasses.field

Configura le opzioni di un singolo campo annotato.

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

Sintassi

dataclasses.field(default_factory=list)

Configura le opzioni di un singolo campo annotato.

MISSING indica un’opzione assente, None è un possibile valore predefinito. metadata è un mapping di sola lettura. La fabbrica viene chiamata una volta per quel campo in ogni istanza che usa il valore predefinito. Quando serve un valore predefinito, default_factory chiama la fabbrica senza argomenti, perciò si passa list. Usare insieme default e default_factory solleva ValueError. Ogni Bag riceve una lista distinta e aggiungere 8 ad a lascia b vuota.

Dalla 3.14 doc documenta il campo.

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

Esempi

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)

Risultato

[8] []

Dalla 3.14 doc documenta il campo.

Fonti