Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła