CKTIS / Python
`cache_info()`: statystyki pamięci podręcznej `lru_cache`
Wywołaj `cache_info()` na funkcji udekorowanej przez `lru_cache`, aby odczytać liczbę trafień i chybień, limit wpisów oraz bieżącą liczbę wpisów.
Wersja: Python 3.12
Składnia
f.cache_info()Jeśli funkcję f udekorowano za pomocą functools.lru_cache, wywołaj f.cache_info() bez argumentów. Metodę udostępnia obiekt opakowujący funkcję, a nie moduł functools. Zwraca ona krotkę nazwaną ze stanem statystyk z chwili odczytu. Sam odczyt nie uruchamia funkcji ani nie zmienia zawartości pamięci podręcznej lub liczników.
Pole hits zlicza wywołania obsłużone zapisanym wynikiem, a misses — wyszukania, przy których wyniku nie znaleziono. maxsize to limit liczby wpisów (None oznacza brak limitu), natomiast currsize to liczba wpisów przechowywanych w chwili odczytu, a nie zużycie pamięci w bajtach. Gdy ograniczona pamięć podręczna jest pełna, dodanie wpisu usuwa wpis najdawniej używany; licznik chybień nie jest licznikiem usunięć.
Odczytaj statystyki po wykonaniu reprezentatywnej serii wywołań, aby ocenić, jak często wykorzystywane są zapisane wyniki i czy warto zmienić maxsize. Te dane nie mierzą czasu wykonania. Aby wyczyścić pamięć podręczną zamiast odczytać statystyki, użyj f.cache_clear().
Przykłady
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}")
Wynik
hits=1, misses=4, maxsize=2, currsize=2
Drugi odczyt dla `2` daje jedyne trafienie i sprawia, że wpis dla `2` jest ostatnio używany. Dodanie wpisu dla `4` usuwa wpis dla `3`, więc ostatnie wywołanie z `3` znów daje chybienie. Łącznie są cztery chybienia, a w pamięci podręcznej pozostają dwa wpisy.
Powiązane lekcje
- Python · Lekcja 17 · Średniozaawansowany · Wersja: 3