Struct ArcMutexGuard

pub struct ArcMutexGuard<R, T>
where
    R: RawMutex,
    T: ?Sized,
{ /* private fields */ }

An RAII mutex guard returned by the Arc locking operations on Mutex.

This is similar to the MutexGuard struct, except instead of using a reference to unlock the Mutex it uses an Arc<Mutex>. This has several advantages, most notably that it has an 'static lifetime.

Implementations

impl<R, T> ArcMutexGuard<R, T>

where R: RawMutex, T: ?Sized,

pub fn mutex(s: &ArcMutexGuard<R, T>) -> &Arc<Mutex<R, T>>

Returns a reference to the Mutex this is guarding, contained in its Arc.

pub fn into_arc(s: ArcMutexGuard<R, T>) -> Arc<Mutex<R, T>>

Unlocks the mutex and returns the Arc that was held by the ArcMutexGuard.

pub fn unlocked<F, U>(s: &mut ArcMutexGuard<R, T>, f: F) -> U

where F: FnOnce() -> U,

Temporarily unlocks the mutex to execute the given function.

This is safe because &mut guarantees that there exist no other references to the data protected by the mutex.

impl<R, T> ArcMutexGuard<R, T>

where R: RawMutexFair, T: ?Sized,

pub fn unlock_fair(s: ArcMutexGuard<R, T>)

Unlocks the mutex using a fair unlock protocol.

This is functionally identical to the unlock_fair method on MutexGuard.

pub fn unlocked_fair<F, U>(s: &mut ArcMutexGuard<R, T>, f: F) -> U

where F: FnOnce() -> U,

Temporarily unlocks the mutex to execute the given function.

This is functionally identical to the unlocked_fair method on MutexGuard.

pub fn bump(s: &mut ArcMutexGuard<R, T>)

Temporarily yields the mutex to a waiting thread if there is one.

This is functionally identical to the bump method on MutexGuard.

Trait Implementations

impl<R, T> Deref for ArcMutexGuard<R, T>

where R: RawMutex, T: ?Sized,

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<R, T> DerefMut for ArcMutexGuard<R, T>

where R: RawMutex, T: ?Sized,

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

Mutably dereferences the value.

impl<R, T> Drop for ArcMutexGuard<R, T>

where R: RawMutex, T: ?Sized,

fn drop(&mut self)

Executes the destructor for this type.

impl<R, T> Send for ArcMutexGuard<R, T>

where R: RawMutex + Send + Sync, T: Send + ?Sized, <R as RawMutex>::GuardMarker: Send,

impl<R, T> Sync for ArcMutexGuard<R, T>

where R: RawMutex + Sync, T: Sync + ?Sized, <R as RawMutex>::GuardMarker: Sync,