IMPORTANT: To view this page as Markdown, append `.md` to the URL (e.g. /docs/manual/basics.md). For the complete Mojo documentation index, see llms.txt.
Skip to main content
Version: Nightly
For the complete Mojo documentation index, see llms.txt. Markdown versions of all pages are available by appending .md to any URL (e.g. /docs/manual/basics.md).

Bencher

struct Bencher

Defines a Bencher struct which facilitates the timing of a target function.

Fields​

  • ​num_iters (Int): Number of iterations to run the target function.
  • ​elapsed (Int): The total time elapsed when running the target function.

Implemented traits​

AnyType, ImplicitlyDeletable, Movable, RegisterPassable

Methods​

__init__​

def __init__(num_iters: Int) -> Self

Constructs a Bencher object to run and time a function.

Args:

  • ​num_iters (Int): Number of times to run the target function.

iter​

def iter[iter_fn: def() capturing thin -> None](mut self)

Returns the total elapsed time by running a target function a particular number of times.

Parameters:

  • ​iter_fn (def() capturing thin -> None): The target function to benchmark.

def iter[IterFn: def() -> None](mut self, f: IterFn)

Returns the total elapsed time by running a target closure a particular number of times.

Parameters:

  • ​IterFn (def() -> None): Type of the closure to benchmark.

Args:

  • ​f (IterFn): The closure to benchmark.

def iter[IterFn: def() raises -> None](mut self, f: IterFn)

Returns the total elapsed time by running a raising target closure a particular number of times.

Parameters:

  • ​IterFn (def() raises -> None): Type of the closure to benchmark.

Args:

  • ​f (IterFn): The closure to benchmark.

Raises:

If the closure raises.

def iter[iter_fn: def() raises capturing thin -> None](mut self)

Returns the total elapsed time by running a target function a particular number of times.

Parameters:

  • ​iter_fn (def() raises capturing thin -> None): The target function to benchmark.

Raises:

If the operation fails.

iter_preproc​

def iter_preproc[iter_fn: def() capturing thin -> None, preproc_fn: def() capturing thin -> None](mut self)

Returns the total elapsed time by running a target function a particular number of times.

Parameters:

  • ​iter_fn (def() capturing thin -> None): The target function to benchmark.
  • ​preproc_fn (def() capturing thin -> None): The function to preprocess the target function.

def iter_preproc[IterFn: def() -> None, PreprocFn: def() -> None](mut self, iter_fn: IterFn, preproc_fn: PreprocFn)

Returns the total elapsed time by running a target function a particular number of times.

Parameters:

  • ​IterFn (def() -> None): The target function type.
  • ​PreprocFn (def() -> None): The preprocess function type.

Args:

  • ​iter_fn (IterFn): The closure carrying the captured state of the target function.
  • ​preproc_fn (PreprocFn): The closure carrying the captured state of the preprocess function.

iter_custom​

def iter_custom[iter_fn: def(Int) raises capturing thin -> Int](mut self)

Times a target function with custom number of iterations.

Parameters:

  • ​iter_fn (def(Int) raises capturing thin -> Int): The target function to benchmark.

def iter_custom[FuncType: def(Int) -> Int](mut self, func: FuncType)

Times a target function with custom number of iterations.

Parameters:

  • ​FuncType (def(Int) -> Int): The target function type.

Args:

  • ​func (FuncType): The closure carrying the captured state of the target function.
View source