Display the source code in std/datetime/stopwatch.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Function `std.datetime.stopwatch.benchmark`

Benchmarks code for speed assessment and comparison.


						
				Duration[fun.length] benchmark(fun...)
				(
				

				  uint n
				

				);

Parameters

Name	Description
fun	aliases of callable objects (e.g. function names). Each callable object should take no arguments.
n	The number of times each function is to be executed.

Returns

The amount of time (as a Duration) that it took to call each function n times. The first value is the length of time that it took to call fun[0] n times. The second value is the length of time it took to call fun[1] n times. Etc.

Example

import std.conv : to;

int a;
void f0() {}
void f1() { auto b = a; }
void f2() { auto b = to!string(a); }
auto r = benchmark!(f0, f1, f2)(10_000);
Duration f0Result = r[0]; // time f0 took to run 10,000 times
Duration f1Result = r[1]; // time f1 took to run 10,000 times
Duration f2Result = r[2]; // time f2 took to run 10,000 times

Authors

Jonathan M Davis and Kato Shoichi

License

Boost License 1.0.