CKTIS / Python
timeit.timeit
timeit измерва общата продължителност на number изпълнения на инструкция или функция без аргументи.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
timeit.timeit(stmt='pass', setup='pass', timer=timeit.default_timer, number=1000000, globals=None)timeit измерва общата продължителност на number изпълнения на инструкция или функция без аргументи.
В API стойността по подразбиране на number е 1_000_000, а python -m timeit без -n автоматично избира броя повторения. setup може да включи GC чрез gc.enable(). Ако измерването е изключило предварително активен GC, го включва отново дори при изключение в инструкцията. Стандартният часовник perf_counter дава секунди. При положителен number делението на number дава средната продължителност на едно изпълнение. setup е извън измерването. Цикличното събиране на отпадъци по подразбиране временно се изключва.
Примерът добавя четири елемента и проверява неотрицателното време.
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()
Примери
import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)
Резултат
4 True
Примерът добавя четири елемента и проверява неотрицателното време.