From 26039d1e0a1da897d28688895126eb8bbd16f2c9 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Fri, 14 Jan 2022 09:47:51 -0800 Subject: [PATCH] bpo-23183: Document the timeit output (GH-30359) Co-authored-by: Robert Collins (cherry picked from commit 73140de97cbeb01bb6c9af1da89ecb9355921e91) Co-authored-by: Hugo van Kemenade --- Doc/library/timeit.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Doc/library/timeit.rst b/Doc/library/timeit.rst index d4e8b749db48..ca21fe622323 100644 --- a/Doc/library/timeit.rst +++ b/Doc/library/timeit.rst @@ -282,6 +282,13 @@ It is possible to provide a setup statement that is executed only once at the be $ python -m timeit -s 'text = "sample string"; char = "g"' 'text.find(char)' 1000000 loops, best of 5: 0.342 usec per loop +In the output, there are three fields. The loop count, which tells you how many +times the statement body was run per timing loop repetition. The repetition +count ('best of 5') which tells you how many times the timing loop was +repeated, and finally the time the statement body took on average within the +best repetition of the timing loop. That is, the time the fastest repetition +took divided by the loop count. + :: >>> import timeit -- 2.47.3