new Benchmark
Returns the current time. By getting the current time before and
after running the code, you can calculate the time it takes the code
to run.
clearallcache
Clears the entire cache. Exported on request.
clearcache (count)
Clears the cached time for count rounds of
the null loop. Exported on request.
Benchmark->debug(flag)
Enables or disables debugging by setting the
$Benchmark::Debug flag.
disablecache
Disables use of the cache. Exported on request.
enablecache
Resumes caching. Exported on request.
timediff (t1, t2)
Calculates the difference between two times and returns the
difference as a Benchmark object suitable for passing to
timestr. Always exported.
timeit (count, code)
Runs code and reports the time it took.
Always exported. Takes the following arguments:
- count
-
The number of times to run the loop
- code
-
The code to run, specified as either a code reference or a string
timestr (timediff[, style[, format]])
Converts times to printable strings. Always exported. Takes the
following arguments:
- timediff
-
The object containing the times to be formatted.
- style
-
The output format. The possible values of style are:
- all
-
Shows all of the following times: wallclock, user, system, user time
of children, and system time of children
- auto
-
Like all, except that if the children times are
both 0, it acts like noc
- noc
-
Shows all except the two children times
- nop
-
Shows only wallclock and the two children times
- format
-
Indicates the printf(3)-style format specifier
(without the leading %) to use for printing the
times. The default is 5.2f.
timethese (count, \%codehashref[, style])
Times each of several pieces of code and reports the results
separately. Always exported. Takes the following arguments:
- count
-
The number of times to run the loop.
- \%codehashref
-
Reference to a hash in which the keys are names and the values are
either strings or code references; each key/value pair specifies a
piece of code to run.
- style
-
Determines the format of the output. See timestr
for the possible values of style.
timethis (count, code[, title[, style]])
Runs a chunk of code several times. Always exported. Takes the
following arguments:
- count
-
The number of times to run the loop.
- code
-
The code to run, specified as either a code reference or a string.
- title
-
The title of the result; default is "timethis
COUNT".
- style
-
Determines the format of the output. See timestr
for the possible values of style.