From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Fri, 14 Jan 2022 17:53:38 +0000 (-0800) Subject: bpo-23183: Document the timeit output (GH-30359) X-Git-Tag: v3.9.11~166 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9badf6895a9bc1b01b2d6b2fb35419e7c5523ce6;p=thirdparty%2FPython%2Fcpython.git bpo-23183: Document the timeit output (GH-30359) Co-authored-by: Robert Collins (cherry picked from commit 73140de97cbeb01bb6c9af1da89ecb9355921e91) Co-authored-by: Hugo van Kemenade --- 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