Struct Bencher 

pub struct Bencher { /* private fields */ }

The Bencher provides iteration control for benchmarks.

Uses Criterion-style batched sampling:

• Warmup phase estimates iteration time
• Measurement phase batches iterations into samples
• Each sample = average of many iterations (reduces noise)

Implementations

impl Bencher

pub fn new(track_allocations: bool) -> Self

Create a new Bencher

pub fn with_config(track_allocations: bool, target_samples: usize) -> Self

Create a Bencher with custom sample count

pub fn set_iters_per_sample(&mut self, iters: u64)

Set iterations per sample (called after warmup estimation)

pub fn estimated_iter_time_ns(&self) -> Option<u64>

Get estimated iteration time from warmup (in nanoseconds)

pub fn start_measurement(&mut self, measurement_time_ns: u64)

Transition from warmup to measurement phase

pub fn iter<T, F>(&mut self, f: F)

where F: FnMut() -> T,

Run the benchmark closure for one iteration.

During warmup: records individual timings for estimation. During measurement: accumulates into batched samples.

pub fn iter_with_setup<T, S, F, R>(&mut self, setup: S, routine: F)

where S: FnMut() -> T, F: FnMut(T) -> R,

Run the benchmark with separate setup phase

pub fn iter_batched<T, S, F, R>( &mut self, batch_size: u64, setup: S, routine: F, )

where S: FnMut() -> T, F: FnMut(&T) -> R,

Run benchmark with batched iterations (user-specified batch size)

pub fn iter_async_standalone<T, F, Fut>(&mut self, f: F)

where F: FnMut() -> Fut, Fut: Future<Output = T>,

Run an async benchmark closure (standalone - creates its own runtime)

pub fn iter_async<T, F, Fut>(&mut self, f: F)

where F: FnMut() -> Fut, Fut: Future<Output = T>,

Run an async benchmark closure within an existing tokio runtime

pub fn has_enough_samples(&self) -> bool

Check if we’ve collected enough samples

pub fn samples(&self) -> &[Sample]

Get collected samples

pub fn take_samples(&mut self) -> Vec<Sample>

Take ownership of collected samples (clears warmup data)

pub fn iteration_count(&self) -> u64

Get total iteration count

pub fn target_samples(&self) -> usize

Get target sample count

pub fn finish(self) -> BenchmarkResult

Finalize and return results