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

CKTIS / Python

functools.cache

Memoriza resultados sem limite como lru_cache(maxsize=None).

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

Sintaxe

@functools.cache

Memoriza resultados sem limite como lru_cache(maxsize=None).

Em CPython, f(1) e f(1.0) criam duas chaves apesar de 1 == 1.0. A chave da chamada tem de admitir hash e outra ordem dos argumentos nomeados pode criar entradas distintas. Argumentos e resultados ficam referenciados até serem removidos. Duas falhas de cache simultâneas podem repetir o cálculo.

Dois square(4) dão 16 e calls contém um único 4.

from functools import cache
@cache
def f(x):
    return object()
a = f(4)
assert f(4) is a and f.cache_info().hits == 1
f.cache_clear()
assert f(4) is not a
try:
    f([])
except TypeError:
    pass
else:
    raise AssertionError
f.cache_clear()
assert f(1) is not f(1.0) and f.cache_info().misses == 2

Exemplos

import functools
calls = []
@functools.cache
def square(n):
    calls.append(n)
    return n * n

print(square(4), square(4), calls)

Resultado

16 16 [4]

Dois square(4) dão 16 e calls contém um único 4.

Fontes