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.

impl ResGuard<HANDLE, fn(_: HANDLE)>

pub fn with_acq_and_close_handle<A, E>( acquire: A ) -> Result<ResGuard<HANDLE, fn(_: HANDLE)>, E>

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

Activate feature HANDLE_CloseHandle.

pub fn with_mut_acq_and_close_handle<A, T, E>( acquire: A ) -> Result<ResGuard<HANDLE, fn(_: HANDLE)>, E>

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

Activate same feature.

impl ResGuard<HBITMAP, fn(_: HBITMAP)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HBITMAP, fn(_: HBITMAP)>, E>

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

Activate feature HBITMAP_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HBITMAP, fn(_: HBITMAP)>, E>

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

Activate same feature.

impl ResGuard<HBRUSH, fn(_: HBRUSH)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HBRUSH, fn(_: HBRUSH)>, E>

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

Activate feature HBRUSH_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HBRUSH, fn(_: HBRUSH)>, E>

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

Activate same feature.

impl ResGuard<HDC, fn(_: HDC)>

pub fn with_acq_and_delete_dc<A, E>( acquire: A ) -> Result<ResGuard<HDC, fn(_: HDC)>, E>

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

Activate feature HDC_DeleteDC.

pub fn with_mut_acq_and_delete_dc<A, T, E>( acquire: A ) -> Result<ResGuard<HDC, fn(_: HDC)>, E>

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

Activate same feature.

impl ResGuard<HFONT, fn(_: HFONT)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HFONT, fn(_: HFONT)>, E>

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

Activate feature HFONT_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HFONT, fn(_: HFONT)>, E>

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

Activate same feature.

impl ResGuard<HGDIOBJ, fn(_: HGDIOBJ)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HGDIOBJ, fn(_: HGDIOBJ)>, E>

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

Activate feature HGDIOBJ_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HGDIOBJ, fn(_: HGDIOBJ)>, E>

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

Activate same feature.

impl ResGuard<HGLOBAL, fn(_: HGLOBAL)>

pub fn with_acq_and_global_free<A, E>( acquire: A ) -> Result<ResGuard<HGLOBAL, fn(_: HGLOBAL)>, E>

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

Activate feature HGLOBAL_GlobalFree.

pub fn with_mut_acq_and_global_free<A, T, E>( acquire: A ) -> Result<ResGuard<HGLOBAL, fn(_: HGLOBAL)>, E>

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

Activate same feature.

impl ResGuard<HICON, fn(_: HICON)>

pub fn with_acq_and_destroy_icon<A, E>( acquire: A ) -> Result<ResGuard<HICON, fn(_: HICON)>, E>

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

Activate feature HICON_DestroyIcon.

pub fn with_mut_acq_and_destroy_icon<A, T, E>( acquire: A ) -> Result<ResGuard<HICON, fn(_: HICON)>, E>

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

Activate same feature.

impl ResGuard<HLOCAL, fn(_: HLOCAL)>

pub fn with_acq_and_local_free<A, E>( acquire: A ) -> Result<ResGuard<HLOCAL, fn(_: HLOCAL)>, E>

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

Activate feature HLOCAL_LocalFree.

pub fn with_mut_acq_and_local_free<A, T, E>( acquire: A ) -> Result<ResGuard<HLOCAL, fn(_: HLOCAL)>, E>

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

Activate same feature.

impl ResGuard<HMENU, fn(_: HMENU)>

pub fn with_acq_and_destroy_menu<A, E>( acquire: A ) -> Result<ResGuard<HMENU, fn(_: HMENU)>, E>

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

Activate feature HMENU_DestroyMenu.

pub fn with_mut_acq_and_destroy_menu<A, T, E>( acquire: A ) -> Result<ResGuard<HMENU, fn(_: HMENU)>, E>

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

Activate same feature.

impl ResGuard<HMODULE, fn(_: HMODULE)>

pub fn with_acq_and_free_library<A, E>( acquire: A ) -> Result<ResGuard<HMODULE, fn(_: HMODULE)>, E>

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

Activate feature HMODULE_FreeLibrary.

pub fn with_mut_acq_and_free_library<A, T, E>( acquire: A ) -> Result<ResGuard<HMODULE, fn(_: HMODULE)>, E>

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

Activate same feature.

impl ResGuard<HPALETTE, fn(_: HPALETTE)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HPALETTE, fn(_: HPALETTE)>, E>

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

Activate feature HPALETTE_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HPALETTE, fn(_: HPALETTE)>, E>

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

Activate same feature.

impl ResGuard<HPEN, fn(_: HPEN)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HPEN, fn(_: HPEN)>, E>

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

Activate feature HPEN_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HPEN, fn(_: HPEN)>, E>

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

Activate same feature.

impl ResGuard<HRGN, fn(_: HRGN)>

pub fn with_acq_and_delete_object<A, E>( acquire: A ) -> Result<ResGuard<HRGN, fn(_: HRGN)>, E>

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

Activate feature HRGN_DeleteObject.

pub fn with_mut_acq_and_delete_object<A, T, E>( acquire: A ) -> Result<ResGuard<HRGN, fn(_: HRGN)>, E>

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

Activate same feature.

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.