Skip to main content

AbortOnDrop

Struct AbortOnDrop 

Source
pub struct AbortOnDrop<'a>(pub &'a str);
Expand description

Zero-sized struct that calls std::process::abort() if dropped

This is useful to make code exception safe. If there is a region that must not panic for safety reasons, you can use this to prevent further unwinding, at least.

Before aborting, the provided string is printed. If the guarded code in the example panics, FATAL: Foo panicked. Aborting. will be printed to stderr.

§Example

let panic_guard = AbortOnDrop("Foo panicked.");
// ... code that might panic ...
panic_guard.defuse();

Tuple Fields§

§0: &'a str

Implementations§

Source§

impl AbortOnDrop<'_>

Source

pub fn defuse(self)

Consume self without aborting the process.

Equivalent to std::mem::forget(self).

Trait Implementations§

Source§

impl<'a> Debug for AbortOnDrop<'a>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Drop for AbortOnDrop<'_>

Source§

fn drop(&mut self)

Executes the destructor for this type. Read more
Source§

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. Read more

Auto Trait Implementations§

§

impl<'a> Freeze for AbortOnDrop<'a>

§

impl<'a> RefUnwindSafe for AbortOnDrop<'a>

§

impl<'a> Send for AbortOnDrop<'a>

§

impl<'a> Sync for AbortOnDrop<'a>

§

impl<'a> Unpin for AbortOnDrop<'a>

§

impl<'a> UnsafeUnpin for AbortOnDrop<'a>

§

impl<'a> UnwindSafe for AbortOnDrop<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.