База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

dataclasses.replace

Създава нов екземпляр от същия тип с посочените промени на полетата.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

dataclasses.replace(obj, /, **changes)

Създава нов екземпляр от същия тип с посочените промени на полетата.

CPython 3.14.9 поражда TypeError както за поле init=False, така и при пропуснат задължителен InitVar. Документацията за 3.14 посочва ValueError за първия случай. Генерираният инициализатор отново извиква __post_init__, така че производните стойности могат да се преизчислят. Промяна на поле init=False поражда TypeError, а всеки InitVar без стойност по подразбиране трябва да се подаде.

Новият Job има приоритет 8, а първоначалният запазва 2.

from dataclasses import dataclass, field, replace
@dataclass
class Price:
    base: int
    total: int = field(init=False)
    def __post_init__(self):
        self.total = self.base * 2
p = Price(3)
assert replace(p, base=5).total == 10 and p.total == 6
try:
    replace(p, total=99)
except TypeError:
    pass
else:
    raise AssertionError
from dataclasses import InitVar
@dataclass
class Seed:
    value: InitVar[int]
try:
    replace(Seed(4))
except TypeError:
    pass
else:
    raise AssertionError

Примери

import dataclasses
@dataclasses.dataclass(frozen=True)
class Job:
    priority: int

a = Job(2)
b = dataclasses.replace(a, priority=8)
print(a.priority, b.priority, a is b)

Резултат

2 8 False

Новият Job има приоритет 8, а първоначалният запазва 2.

Източници