CKTIS / Python
timeit.timeit
timeit meet de totale duur van number uitvoeringen van een opdracht of een functie zonder argumenten.
Versie: 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 meet de totale duur van number uitvoeringen van een opdracht of een functie zonder argumenten.
In de API is number standaard 1_000_000, terwijl python -m timeit zonder -n het aantal herhalingen automatisch kiest. setup kan de GC inschakelen met gc.enable(). Heeft de meting een eerder actieve GC uitgeschakeld, dan schakelt ze die zelfs na een uitzondering weer in. De standaardklok perf_counter geeft seconden. Bij een positieve number geeft delen door number de gemiddelde tijd per uitvoering. setup valt buiten de meting. Cyclische afvalinzameling wordt standaard tijdelijk uitgeschakeld.
Het voorbeeld voegt vier elementen toe en controleert dat de duur niet negatief is.
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()
Voorbeelden
import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)
Resultaat
4 True
Het voorbeeld voegt vier elementen toe en controleert dat de duur niet negatief is.