Struct windows_helpers::ResGuard

pub struct ResGuard<R, F>
where
    F: FnOnce(R),
{ /* private fields */ }

Holds a resource and a free-closure that is called when the guard is dropped.

Allows to couple resource acquisition and freeing, while treating the guard as the contained resource and ensuring freeing will happen. When writing the code, it’s also nice to transfer the documentation into everything that has to happen in one go without having to split it into upper and lower or here- and there-code. In a function, Rust’s drop order should ensure that later aquired resources are freed first.

Implementations

impl<R, F> ResGuard<R, F>

where F: FnOnce(R),

pub fn new(resource: R, free: F) -> Self

Should normally not be needed.

pub fn with_acquisition<A, E>(acquire: A, free: F) -> Result<Self, E>

where A: FnOnce() -> Result<R, E>,

For functions that return the resource.

pub fn with_mut_acquisition<A, T, E>(acquire: A, free: F) -> Result<Self, E>

where A: FnOnce(&mut R) -> Result<T, E>, R: Default,

For functions that provide the resource by means of an out-parameter.

Trait Implementations

impl<R, F> Deref for ResGuard<R, F>

where F: FnOnce(R),

type Target = R

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<R, F> Drop for ResGuard<R, F>

where F: FnOnce(R),

fn drop(&mut self)

Executes the destructor for this type.