Struct Bomb 

pub struct Bomb<F: FnOnce()> {
    callback: Option<F>,
}

Runs f when dropped — like defer — unless it has been defused first.

Handy for “do this unless we get there cleanly”: arm the bomb, then defuse it on every success path, so f runs only when the bomb is dropped early — e.g. an owning task is cancelled, or a ?/panic unwinds past it.

For the common “this must happen before drop, or it is a bug” case, see Bomb::panic.

Fields

callback: Option<F>

Implementations

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

pub fn new(f: F) -> Self

Arms a bomb that runs f when dropped.

pub fn defuse(&mut self)

Defuses the bomb so f will not run (dropping f, and so releasing whatever it captured).

impl Bomb<Box<dyn FnOnce()>>

pub fn panic(msg: impl FnOnce() -> String + 'static) -> Self

Arms a bomb that logs msg and then panics when dropped (unless the thread is already panicking) — i.e. asserts that the bomb is defused before it is dropped.

Trait Implementations

impl<F: FnOnce()> Drop for Bomb<F>

fn drop(&mut self)

Executes the destructor for this type.