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

CKTIS / Python

timeit.Timer

Timer guarda a instrução e a preparação como texto ou funções sem argumentos.

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

Sintaxe

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

Timer guarda a instrução e a preparação como texto ou funções sem argumentos.

autorange(callback) chama callback(number, time_taken) após cada ensaio, incluindo o último. Devolve o último par (number, time_taken), por exemplo (2, 0.3) após (1, 0.1) e (2, 0.3). O dicionário globals disponibiliza nomes às instruções em texto. No exemplo, timeit(2) executa setup uma vez fora da medição e run duas vezes. Mesmo timeit(0) executa setup.

autorange experimenta 1, 2, 5, 10 e mais iterações até um ensaio durar pelo menos 0,2 segundos.

import timeit
events=[]
timer=timeit.Timer("events.append('run')","events.append('setup')",globals={'events':events})
timer.timeit(0)
assert events==['setup']
timer.repeat(repeat=2,number=1)
assert events==['setup','setup','run','setup','run']
ticks=iter([0.,0.1,0.,0.3])
runs=[]
assert timeit.Timer(lambda:runs.append(1), timer=lambda:next(ticks)).autorange()==(2,0.3)
assert len(runs)==3
ticks=iter([0.,0.1,0.,0.3])
samples=[]
pair=timeit.Timer('pass',timer=lambda:next(ticks)).autorange(lambda n,t:samples.append((n,t)))
assert samples==[(1,0.1),(2,0.3)] and pair==samples[-1]

Exemplos

import timeit
events = []
timer = timeit.Timer(lambda: events.append("run"), setup=lambda: events.append("setup"))
timer.timeit(number=2)
print(events)

Resultado

['setup', 'run', 'run']

autorange experimenta 1, 2, 5, 10 e mais iterações até um ensaio durar pelo menos 0,2 segundos.

Fontes