Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

functools.cached_property

O primeiro acesso calcula o valor e guarda-o com o mesmo nome no `__dict__` modificável da instância.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

@functools.cached_property

O primeiro acesso calcula o valor e guarda-o com o mesmo nome no __dict__ modificável da instância.

A atribuição substitui-o e a remoção permite recalcular. Sem dicionário de instância não funciona. Desde 3.12 não há bloqueio interno e acessos simultâneos podem repetir o cálculo.

Aqui obtêm-se 6, 6, 10.

from functools import cached_property
class Sample:
    @cached_property
    def value(self):
        return object()
s = Sample()
v = s.value
assert s.value is v and s.__dict__["value"] is v
s.value = 4
assert s.value == 4
del s.value
assert s.value is not v

Exemplos

import functools
class Sample:
    value = 3
    @functools.cached_property
    def twice(self): return self.value * 2

s = Sample()
print(s.twice)
s.value = 5
print(s.twice)
del s.twice
print(s.twice)

Resultado

6
6
10

Aqui obtêm-se 6, 6, 10.

Fontes