Struct OwnedGuard

pub struct OwnedGuard<'a> { /* private fields */ }

A guard that protects objects for it’s lifetime, independent of the current thread.

Unlike LocalGuard, an owned guard is independent of the current thread, allowing them to implement Send. This is useful for holding guards across .await points in work-stealing schedulers, where execution may be resumed on a different thread than started on. However, owned guards are more expensive to create and destroy, so should be avoided if cross-thread usage is not required.

Most of the functionality provided by this type is through the Guard trait.

Trait Implementations

impl Drop for OwnedGuard<'_>

fn drop(&mut self)

Executes the destructor for this type.

impl Guard for OwnedGuard<'_>

fn protect<T>(&self, ptr: &AtomicPtr<T>, _: Ordering) -> *mut T

where T: AsLink,

Protects the load of an atomic pointer.

unsafe fn defer_retire<T>(&self, ptr: *mut T, reclaim: unsafe fn(_: *mut Link))

where T: AsLink,

Retires a value, running reclaim when no threads hold a reference to it.

fn refresh(&mut self)

Refreshes the guard.

fn flush(&self)

Flush any retired values in the local batch.

fn thread_id(&self) -> usize

Returns a numeric identifier for the current thread.

fn belongs_to(&self, collector: &Collector) -> bool

Returns true if this guard belongs to the given collector.

fn link(&self, _collector: &Collector) -> Link

Create a Link that can be used to link an object to the collector.

impl Send for OwnedGuard<'_>

impl Sync for OwnedGuard<'_>