Struct IterOptions 

pub struct IterOptions { /* private fields */ }

Configuration options for iterators.

Controls prefetching, metrics collection, and other iterator behaviors that affect scan performance.

Example

let options = IterOptions::default()
    .prefetch_count(32)
    .collect_metrics(true);
let iter = rtx.iter_with_options(options);

Implementations

impl IterOptions

pub fn new() -> Self

Creates new iterator options with default settings.

pub fn prefetch_count(self, count: usize) -> Self

Sets the number of entries to prefetch ahead.

Arguments

• count - Number of entries to prefetch (0 to disable prefetching)

Performance

• Values 16-64 work well for most workloads.
• Higher values benefit large sequential scans.
• Lower values are better for selective scans with early termination.

pub fn collect_metrics(self, collect: bool) -> Self

Enables or disables metrics collection.

When enabled, the iterator tracks:

• Number of keys scanned
• Bytes scanned
• Total scan duration

pub fn forward_only(self, forward: bool) -> Self

Indicates whether this will be a forward-only scan.

Forward-only scans can enable additional optimizations like sequential read-ahead.

Trait Implementations

impl Clone for IterOptions

fn clone(&self) -> IterOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IterOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for IterOptions

fn default() -> Self

Returns the “default value” for a type.