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

CKTIS / Python

functools.lru_cache

Stocke les résultats par clés hachables et évince à saturation l’entrée la moins récemment consultée.

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

Syntaxe

@functools.lru_cache(maxsize=128, typed=False)

Stocke les résultats par clés hachables et évince à saturation l’entrée la moins récemment consultée.

Avec typed=False, deux valeurs égales de types différents peuvent avoir des clés distinctes. Le cache reste cohérent entre threads, mais deux appels simultanés sans résultat en cache peuvent refaire le même calcul. maxsize=None supprime la limite et zéro désactive le stockage. typed=True distingue les types des arguments directs. Avec une place et 1,1,2,1 le deuxième 1 réussit, le dernier est recalculé.

On compte un succès et trois absences.

from functools import lru_cache
@lru_cache(maxsize=2, typed=True)
def f(x): return x
assert f(1) == f(1.0) and f.cache_info().currsize == 2
f(1)
f(3)
assert f.cache_info().hits == 1
f(1.0)
assert f.cache_info().misses == 4
@lru_cache(typed=False)
def kind(x): return type(x)
assert kind(1) is int and kind(1.0) is float

lru_cache wrapper.cache_info

cache_info() sur la fonction décorée renvoie un tuple nommé. hits compte les succès, misses les absences, maxsize est la limite configurée et currsize le nombre d’entrées présentes. Après éviction currsize peut être inférieur à misses.

from functools import lru_cache
@lru_cache(maxsize=2)
def square(n): return n*n
for n in (2,2,3,4): square(n)
info=square.cache_info()
assert (info.hits,info.misses,info.maxsize,info.currsize)==(1,3,2,2)
square.cache_clear()
assert square.cache_info().currsize==0

Exemples

import functools
@functools.lru_cache(maxsize=1)
def twice(n): return n * 2

print([twice(n) for n in (1, 1, 2, 1)])
info = twice.cache_info()
print(info.hits, info.misses)

Résultat

[2, 2, 4, 2]
1 3

On compte un succès et trois absences.

Sources