Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

timeit.timeit

timeit mede a duração total de number execuções de uma instrução ou de uma função sem argumentos.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

timeit.timeit(stmt='pass', setup='pass', timer=timeit.default_timer, number=1000000, globals=None)

timeit mede a duração total de number execuções de uma instrução ou de uma função sem argumentos.

Na API, number vale 1_000_000 por omissão, enquanto python -m timeit sem -n escolhe automaticamente o número de repetições. setup pode ativar o GC com gc.enable(). Se a medição desativou o GC anteriormente ativo, volta a ativá-lo mesmo que a instrução lance uma exceção. O relógio predefinido perf_counter dá segundos. Para number positivo, dividir por number dá a média por execução. setup fica fora da medição. Por omissão, a recolha de ciclos é temporariamente desativada.

O exemplo acrescenta quatro elementos e verifica que o tempo é não negativo.

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()

Exemplos

import timeit
calls = []
elapsed = timeit.timeit(lambda: calls.append(1), number=4)
print(len(calls), elapsed >= 0)

Resultado

4 True

O exemplo acrescenta quatro elementos e verifica que o tempo é não negativo.

Fontes