CKTIS / Python
`cache_info()`: čtení statistik mezipaměti `lru_cache`
Metoda `cache_info()` u funkce dekorované pomocí `lru_cache` vrací počty nalezených a nenalezených výsledků, limit položek a aktuální počet uložených položek.
Verze: Python 3.12
Syntaxe
f.cache_info()Je-li funkce f dekorována pomocí functools.lru_cache, zavolej f.cache_info() bez argumentů. Metodu poskytuje obal funkce, nikoli modul functools. Vrací n-tici s pojmenovanými poli, která zachycuje stav statistik v okamžiku čtení. Čtení nespouští původní funkci ani nemění obsah mezipaměti či počítadla.
hits počítá volání, při nichž se použil uložený výsledek; misses počítá vyhledání, při nichž se výsledek nenašel. maxsize je limit počtu položek (None znamená, že limit není nastaven). currsize je aktuální počet uložených položek, nikoli spotřeba paměti v bajtech. Když je omezená mezipaměť plná, nová položka vytlačí tu nejdéle nepoužitou. Počet nenalezených výsledků neudává počet vytlačených položek.
Statistiky čti po reprezentativní sérii volání. Zjistíš, jak často se výsledky znovu používají a zda má smysl upravit maxsize. Tyto údaje neměří dobu běhu. Chceš-li mezipaměť vyprázdnit namísto čtení statistik, použij f.cache_clear().
Příklady
from functools import lru_cache
@lru_cache(maxsize=2)
def square(n):
return n * n
for n in (2, 3, 2, 4, 3):
square(n)
info = square.cache_info()
print(f"hits={info.hits}, misses={info.misses}, maxsize={info.maxsize}, currsize={info.currsize}")
Výsledek
hits=1, misses=4, maxsize=2, currsize=2
Při druhém vyhledání hodnoty `2` se uložený výsledek najde jako jediný a položka se stane naposledy použitou. Přidání položky pro `4` vytlačí položku pro `3`, takže při posledním volání s `3` se výsledek opět nenajde. Celkem jsou čtyři neúspěšná vyhledání a v mezipaměti zůstávají dvě položky.
Související lekce
- Python · Lekce 17 · Středně pokročilá · Verze: 3