[−][src]Struct futures::sync::BiLock
A type of futures-powered synchronization primitive which is a mutex between two possible owners.
This primitive is not as generic as a full-blown mutex but is sufficient for
many use cases where there are only two possible owners of a resource. The
implementation of BiLock
can be more optimized for just the two possible
owners.
Note that it's possible to use this lock through a poll-style interface with
the poll_lock
method but you can also use it as a future with the lock
method that consumes a BiLock
and returns a future that will resolve when
it's locked.
A BiLock
is typically used for "split" operations where data which serves
two purposes wants to be split into two to be worked with separately. For
example a TCP stream could be both a reader and a writer or a framing layer
could be both a stream and a sink for messages. A BiLock
enables splitting
these two and then using each independently in a futures-powered fashion.
Methods
impl<T> BiLock<T>
[src]
pub fn new(t: T) -> (BiLock<T>, BiLock<T>)
[src]
Creates a new BiLock
protecting the provided data.
Two handles to the lock are returned, and these are the only two handles that will ever be available to the lock. These can then be sent to separate tasks to be managed there.
pub fn poll_lock(&self) -> Async<BiLockGuard<T>>
[src]
Attempt to acquire this lock, returning NotReady
if it can't be
acquired.
This function will acquire the lock in a nonblocking fashion, returning
immediately if the lock is already held. If the lock is successfully
acquired then Async::Ready
is returned with a value that represents
the locked value (and can be used to access the protected data). The
lock is unlocked when the returned BiLockGuard
is dropped.
If the lock is already held then this function will return
Async::NotReady
. In this case the current task will also be scheduled
to receive a notification when the lock would otherwise become
available.
Panics
This function will panic if called outside the context of a future's task.
pub fn lock(self) -> BiLockAcquire<T>
[src]
Perform a "blocking lock" of this lock, consuming this lock handle and returning a future to the acquired lock.
This function consumes the BiLock<T>
and returns a sentinel future,
BiLockAcquire<T>
. The returned future will resolve to
BiLockAcquired<T>
which represents a locked lock similarly to
BiLockGuard<T>
.
Note that the returned future will never resolve to an error.
pub fn reunite(self, other: Self) -> Result<T, ReuniteError<T>>
[src]
Attempts to put the two "halves" of a BiLock<T>
back together and
recover the original value. Succeeds only if the two BiLock<T>
s
originated from the same call to BiLock::new
.
Trait Implementations
Auto Trait Implementations
impl<T> Unpin for BiLock<T>
impl<T> Send for BiLock<T> where
T: Send,
T: Send,
impl<T> Sync for BiLock<T> where
T: Send,
T: Send,
impl<T> !UnwindSafe for BiLock<T>
impl<T> !RefUnwindSafe for BiLock<T>
Blanket Implementations
impl<T> From<T> for T
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,