diff options
author | Jarkko Hietaniemi <jhi@iki.fi> | 1999-10-02 10:16:15 +0000 |
---|---|---|
committer | Jarkko Hietaniemi <jhi@iki.fi> | 1999-10-02 10:16:15 +0000 |
commit | ac8eabc1ebb57d426c973b83f7ee5241b2084b4e (patch) | |
tree | d76f755ddce234b9b4a96a8f7c276540079b1cc6 /lib/Benchmark.pm | |
parent | 753475910d236d4619b2ae7f227546a173a3101e (diff) | |
download | perl-ac8eabc1ebb57d426c973b83f7ee5241b2084b4e.tar.gz |
Battle namespace pollution.
p4raw-id: //depot/cfgperl@4285
Diffstat (limited to 'lib/Benchmark.pm')
-rw-r--r-- | lib/Benchmark.pm | 71 |
1 files changed, 36 insertions, 35 deletions
diff --git a/lib/Benchmark.pm b/lib/Benchmark.pm index a7debd73ee..08caa48349 100644 --- a/lib/Benchmark.pm +++ b/lib/Benchmark.pm @@ -99,34 +99,6 @@ if you use the Benchmark module: =over 10 -=item cmpthese ( COUT, CODEHASHREF, [ STYLE ] ) - -=item cmpthese ( RESULTSHASHREF ) - -Optionally calls timethese(), then outputs comparison chart. This -chart is sorted from slowest to highest, and shows the percent -speed difference between each pair of tests. Can also be passed -the data structure that timethese() returns: - - $results = timethese( .... ); - cmpthese( $results ); - -Returns the data structure returned by timethese(). - -=item countit(TIME, CODE) - -Arguments: TIME is the minimum length of time to run CODE for, and CODE is -the code to run. CODE may be either a code reference or a string to -be eval'd; either way it will be run in the caller's package. - -TIME is I<not> negative. countit() will run the loop many times to -calculate the speed of CODE before running it for TIME. The actual -time run for will usually be greater than TIME due to system clock -resolution, so it's best to look at the number of iterations divided -by the times that you are concerned with, not just the iterations. - -Returns: a Benchmark object. - =item timeit(COUNT, CODE) Arguments: COUNT is the number of times to run the loop, and CODE is @@ -187,11 +159,6 @@ Returns a hash of Benchmark objects, keyed by name. Returns the difference between two Benchmark times as a Benchmark object suitable for passing to timestr(). -=item timesum ( T1, T2 ) - -Returns the sum of two Benchmark times as a Benchmark object suitable -for passing to timestr(). - =item timestr ( TIMEDIFF, [ STYLE, [ FORMAT ] ] ) Returns a string that formats the times in the TIMEDIFF object in @@ -226,6 +193,34 @@ Clear the cached time for COUNT rounds of the null loop. Clear all cached times. +=item cmpthese ( COUT, CODEHASHREF, [ STYLE ] ) + +=item cmpthese ( RESULTSHASHREF ) + +Optionally calls timethese(), then outputs comparison chart. This +chart is sorted from slowest to highest, and shows the percent +speed difference between each pair of tests. Can also be passed +the data structure that timethese() returns: + + $results = timethese( .... ); + cmpthese( $results ); + +Returns the data structure returned by timethese(). + +=item countit(TIME, CODE) + +Arguments: TIME is the minimum length of time to run CODE for, and CODE is +the code to run. CODE may be either a code reference or a string to +be eval'd; either way it will be run in the caller's package. + +TIME is I<not> negative. countit() will run the loop many times to +calculate the speed of CODE before running it for TIME. The actual +time run for will usually be greater than TIME due to system clock +resolution, so it's best to look at the number of iterations divided +by the times that you are concerned with, not just the iterations. + +Returns: a Benchmark object. + =item disablecache ( ) Disable caching of timings for the null loop. This will force Benchmark @@ -237,6 +232,11 @@ Enable caching of timings for the null loop. The time taken for COUNT rounds of the null loop will be calculated only once for each different COUNT used. +=item timesum ( T1, T2 ) + +Returns the sum of two Benchmark times as a Benchmark object suitable +for passing to timestr(). + =back =head1 NOTES @@ -324,8 +324,9 @@ sub _doeval { eval shift } use Carp; use Exporter; @ISA=(Exporter); -@EXPORT=qw(cmpthese countit timeit timethis timethese timediff timestr); -@EXPORT_OK=qw(clearcache clearallcache disablecache enablecache); +@EXPORT=qw(timeit timethis timethese timediff timestr); +@EXPORT_OK=qw(timesum cmpthese countit + clearcache clearallcache disablecache enablecache); &init; |