CKTIS / Python
functools.lru_cache
Пази резултати по хешируеми ключове и при запълване премахва най-отдавна използвания запис.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
@functools.lru_cache(maxsize=128, typed=False)Пази резултати по хешируеми ключове и при запълване премахва най-отдавна използвания запис.
При typed=False равни стойности от различни типове могат да имат отделни ключове. Кешът остава съгласуван при едновременен достъп от нишки, но две едновременни пропускания могат да повторят изчислението. maxsize=None премахва границата, а нула изключва съхранението. typed=True различава типовете на преките аргументи. При едно място и 1,1,2,1 втората единица е попадение, а последната се пресмята отново.
Получават се едно попадение и три пропуска.
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() на декорираната функция връща именуван кортеж. hits брои попаденията, misses пропуските, maxsize е зададеният лимит, а currsize текущият брой записи. След изместване currsize може да е по-малък от 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
Примери
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)
Резултат
[2, 2, 4, 2] 1 3
Получават се едно попадение и три пропуска.