CKTIS / Python
`cache_info()`: Statistiken zu `lru_cache` abfragen
Rufe `cache_info()` an einer mit `lru_cache` dekorierten Funktion auf, um Treffer, Fehltreffer, die Obergrenze und die aktuelle Anzahl der Cache-Einträge abzulesen.
Version: Python 3.12
Syntax
f.cache_info()Wenn f mit functools.lru_cache dekoriert ist, rufe f.cache_info() ohne Argumente auf. Die Methode gehört zur Wrapper-Funktion, nicht zum Modul functools. Sie liefert ein benanntes Tupel mit dem Stand der Statistik zum Zeitpunkt der Abfrage. Dabei wird weder die ursprüngliche Funktion ausgeführt noch werden Cache-Inhalt oder Zähler geändert.
hits zählt Aufrufe, die ein gespeichertes Ergebnis verwenden; misses zählt Abfragen, bei denen kein Ergebnis im Cache gefunden wird. maxsize ist die Obergrenze für die Zahl der Einträge (None bedeutet unbegrenzt). currsize ist die aktuelle Anzahl gespeicherter Einträge, nicht der Speicherverbrauch in Bytes. Ist ein begrenzter Cache voll, verdrängt ein neuer Eintrag den am längsten nicht verwendeten Eintrag. Fehltreffer zählen keine Verdrängungen.
Lies die Statistik nach einer repräsentativen Reihe von Aufrufen ab, um zu sehen, wie oft Ergebnisse wiederverwendet werden und ob sich eine Anpassung von maxsize lohnt. Die Werte messen keine Laufzeit. Verwende f.cache_clear(), wenn du den Cache leeren statt abfragen möchtest.
Beispiele
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}")
Ergebnis
hits=1, misses=4, maxsize=2, currsize=2
Der zweite Zugriff mit `2` ist der einzige Treffer und macht diesen Eintrag zum zuletzt verwendeten. Beim Speichern des Ergebnisses für `4` wird der Eintrag für `3` verdrängt, sodass der letzte Aufruf mit `3` erneut ein Fehltreffer ist. Insgesamt gibt es vier Fehltreffer, und zwei Einträge bleiben im Cache.
Zugehörige Lektionen
- Python · Lektion 17 · Mittlere Stufe · Version: 3