Enum ObserverMode 

#[non_exhaustive]
pub enum ObserverMode {
    Never,
    Always,
    Every(u64),
}

Per-registration policy for observe_iter.

Never and Every gate the iteration callback only — observe_init and observe_final always fire. A user who wants to fully disable an observer should simply not register it.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Never

Skip observe_iter entirely. The observer still sees observe_init / observe_final.

Always

Fire observe_iter on every iteration.

Every(u64)

Fire observe_iter on iterations whose (post-increment) counter is a multiple of n. Every(1) is equivalent to Always; Every(0) is rejected as nonsensical and panics on construction via every, but raw construction is permitted and treated as Never (no iter is a multiple of zero under the iter % n == 0 rule because n == 0 would divide-by-zero — the executor checks for n != 0 before the modulus).

Implementations

impl ObserverMode

pub fn every(n: u64) -> Self

Construct an Every(n) mode, panicking when n == 0.

Prefer this over the raw variant when n comes from user input.

Trait Implementations

impl Clone for ObserverMode

fn clone(&self) -> ObserverMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ObserverMode

impl Debug for ObserverMode

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

Formats the value using the given formatter.

impl Eq for ObserverMode

impl PartialEq for ObserverMode

fn eq(&self, other: &ObserverMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ObserverMode