Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

dataclasses.field

Règle les options d’un champ annoté.

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

Syntaxe

dataclasses.field(default_factory=list)

Règle les options d’un champ annoté.

MISSING signifie absence de réglage, None est une valeur par défaut possible. metadata est une table en lecture seule. La fabrique est appelée une fois pour ce champ par instance qui utilise la valeur par défaut. Si une valeur par défaut est nécessaire, default_factory appelle la fabrique sans argument, d’où le passage de list elle-même. Fournir default et default_factory ensemble lève ValueError. Chaque Bag reçoit sa liste, ajouter 8 dans a laisse b vide.

Depuis 3.14 doc documente le champ.

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

Exemples

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)

Résultat

[8] []

Depuis 3.14 doc documente le champ.

Sources