Struct DeferGuard 

pub struct DeferGuard<F: FnOnce(), S: Strategy = Always> { /* private fields */ }

Holds a synchronous action for at-most-once deferred execution.

The strategy decides whether the action runs when the guard is dropped. Calling DeferGuard::disarm returns the action without executing it, while DeferGuard::run_now executes it immediately regardless of the strategy. Panics from the strategy or a drop-time action propagate. A second panic during unwinding may abort the process.

Implementations

impl<F: FnOnce()> DeferGuard<F>

pub const fn new(action: F) -> Self

Arms action with the Always strategy.

impl<F: FnOnce(), S: Strategy> DeferGuard<F, S>

pub const fn with_strategy(action: F) -> Self

Arms action with strategy S.

pub fn disarm(self) -> F

Disarms the guard and returns its action without executing it.

pub fn run_now(self)

Executes the action immediately, regardless of S, and consumes the guard.

Trait Implementations

impl<F: FnOnce(), S: Strategy> Debug for DeferGuard<F, S>

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

Formats the value using the given formatter.

impl<F: FnOnce(), S: Strategy> Drop for DeferGuard<F, S>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.