CKTIS / Python
timeit.timeit
timeit misst die Gesamtdauer von number Ausführungen einer Anweisung oder einer Funktion ohne Argumente.
Version: Python 3.14; repository image, production runtime not attested
Syntax
timeit.timeit(stmt='pass', setup='pass', timer=timeit.default_timer, number=1000000, globals=None)timeit misst die Gesamtdauer von number Ausführungen einer Anweisung oder einer Funktion ohne Argumente.
Im API beträgt number standardmäßig 1_000_000, während python -m timeit ohne -n die Wiederholungszahl automatisch wählt. setup kann die GC mit gc.enable() aktivieren. Hat die Messung eine zuvor aktive GC abgeschaltet, aktiviert sie diese auch nach einer Ausnahme der Anweisung wieder. Die Standarduhr perf_counter liefert Sekunden. Für positives number ergibt die Division durch number den Mittelwert pro Durchlauf. setup liegt außerhalb der Messung. Die zyklische Speicherbereinigung ist während der Messung standardmäßig deaktiviert.
Das Beispiel hängt vier Elemente an und prüft die nichtnegative Zeit.
import timeit,gc
ticks=iter([1.,3.])
steps=[]
elapsed=timeit.timeit(lambda: steps.append(gc.isenabled()), lambda: steps.append('setup'), timer=lambda:next(ticks),number=3)
assert elapsed==2. and steps==['setup',False,False,False]
old=gc.isenabled()
try:
gc.enable()
def fail():
assert not gc.isenabled()
raise ValueError('timed')
try: timeit.timeit(fail,number=1)
except ValueError: pass
else: raise AssertionError
assert gc.isenabled()
seen=[]
timeit.timeit(lambda:seen.append(gc.isenabled()), setup=gc.enable,number=1)
assert seen==[True]
finally:
if not old: gc.disable()
Beispiele
import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)
Ergebnis
4 True
Das Beispiel hängt vier Elemente an und prüft die nichtnegative Zeit.