KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

`cache_info()`: statistieken van `lru_cache` bekijken

Roep `cache_info()` aan op een met `lru_cache` gedecoreerde functie om hits, misses, de limiet en het huidige aantal cache-items af te lezen.

Versie: Python 3.12

Syntax

f.cache_info()

Als f met functools.lru_cache is gedecoreerd, roep je f.cache_info() zonder argumenten aan. De methode hoort bij de wrapper, niet bij de module functools. Ze geeft een benoemde tuple terug met de statistieken op het moment van opvragen. Bij het uitlezen wordt de oorspronkelijke functie niet uitgevoerd en veranderen de cache-inhoud en de tellers niet.

hits telt aanroepen die een opgeslagen resultaat hergebruiken; misses telt zoekacties waarvoor geen resultaat in de cache staat. maxsize is het maximumaantal items (None betekent dat er geen limiet is). currsize is het huidige aantal opgeslagen items, niet het geheugengebruik in bytes. Is een begrensde cache vol, dan verdringt een nieuw item het item dat het langst niet is gebruikt. Het aantal misses is geen telling van verdrongen items.

Lees de statistieken na een representatieve reeks aanroepen om te zien hoe vaak resultaten worden hergebruikt en of het zinvol is om maxsize aan te passen. Deze cijfers meten geen uitvoeringstijd. Gebruik f.cache_clear() als je de cache wilt legen in plaats van de statistieken op te vragen.

Voorbeelden

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}")

Resultaat

hits=1, misses=4, maxsize=2, currsize=2

De tweede zoekactie voor `2` is de enige hit en maakt dat item het laatst gebruikte. Toevoegen van het item voor `4` verdringt dat voor `3`, dus de laatste aanroep met `3` levert opnieuw een miss op. In totaal zijn er vier misses en blijven er twee items in de cache.

Gerelateerde lessen

  • Python · Les 17 · Gemiddeld · Versie: 3

Bronnen