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

CKTIS / Python

functools.cache

Mémorise les résultats sans limite comme lru_cache(maxsize=None).

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

Syntaxe

@functools.cache

Mémorise les résultats sans limite comme lru_cache(maxsize=None).

Dans CPython, f(1) et f(1.0) produisent deux clés malgré 1 == 1.0. La clé d’appel doit être hachable et un ordre différent des arguments nommés peut créer une autre entrée. Arguments et résultats restent référencés jusqu’au retrait. Deux absences simultanées peuvent répéter le calcul.

Deux square(4) donnent 16 et calls contient un seul 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

Exemples

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

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

Résultat

16 16 [4]

Deux square(4) donnent 16 et calls contient un seul 4.

Sources