Struct try_lock::TryLock

[+] Show declaration

pub struct TryLock<T> { /* fields omitted */ }

[−] Expand description

A light-weight lock guarded by an atomic boolean.

Most efficient when contention is low, acquiring the lock is a single atomic swap, and releasing it just 1 more atomic swap.

It is only possible to try to acquire the lock, it is not possible to wait for the lock to become ready, like with a Mutex.

Methods

impl<T> TryLock<T>[−]

pub fn new(val: T) -> TryLock<T>[−]

Create a TryLock around the value.

pub fn try_lock(&self) -> Option<Locked<T>>[−]

Try to acquire the lock of this value.

If the lock is already acquired by someone else, this returns None. You can try to acquire again whenever you want, perhaps by spinning a few times, or by using some other means of notification.

Note

The default memory ordering is to use Acquire to lock, and Release to unlock. If different ordering is required, use try_lock_order.

pub fn try_lock_order(
    &self,
    lock_order: Ordering,
    unlock_order: Ordering
) -> Option<Locked<T>>[−]

Try to acquire the lock of this value using the lock and unlock orderings.

If the lock is already acquired by someone else, this returns None. You can try to acquire again whenever you want, perhaps by spinning a few times, or by using some other means of notification.

pub fn into_inner(self) -> T[−]

Take the value back out of the lock when this is the sole owner.

Trait Implementations

impl<T: Send> Sync for TryLock<T>

impl<T: Default> Default for TryLock<T>[+]

[+] Show hidden undocumented items

fn default() -> TryLock<T>[−]

Returns the "default value" for a type.

impl<T: Send> Send for TryLock<T>

impl<T: Debug> Debug for TryLock<T>[+]

[+] Show hidden undocumented items

fn fmt(&self, f: &mut Formatter) -> Result[−]

Formats the value using the given formatter.