Struct qfile::AsyncMutex

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

An async mutex.

Implementations

impl<T> Mutex<T>

pub const fn new(data: T) -> Mutex<T>

Creates a new async mutex.

Examples

use async_mutex::Mutex;

let mutex = Mutex::new(0);

pub fn into_inner(self) -> T

Consumes the mutex, returning the underlying data.

Examples

use async_mutex::Mutex;

let mutex = Mutex::new(10);
assert_eq!(mutex.into_inner(), 10);

impl<T> Mutex<T>where T: ?Sized,

pub async fn lock(&self) -> impl Future<Output = MutexGuard<'_, T>>

Acquires the mutex.

Returns a guard that releases the mutex when dropped.

Examples

use async_mutex::Mutex;

let mutex = Mutex::new(10);
let guard = mutex.lock().await;
assert_eq!(*guard, 10);

pub fn try_lock(&self) -> Option<MutexGuard<'_, T>>

Attempts to acquire the mutex.

If the mutex could not be acquired at this time, then None is returned. Otherwise, a guard is returned that releases the mutex when dropped.

Examples

use async_mutex::Mutex;

let mutex = Mutex::new(10);
if let Some(guard) = mutex.try_lock() {
    assert_eq!(*guard, 10);
}

pub fn get_mut(&mut self) -> &mut T

Returns a mutable reference to the underlying data.

Since this call borrows the mutex mutably, no actual locking takes place – the mutable borrow statically guarantees the mutex is not already acquired.

Examples

use async_mutex::Mutex;

let mut mutex = Mutex::new(0);
*mutex.get_mut() = 10;
assert_eq!(*mutex.lock().await, 10);

impl<T> Mutex<T>where T: ?Sized,

pub async fn lock_arc( self: &Arc<Mutex<T>> ) -> impl Future<Output = MutexGuardArc<T>>

Acquires the mutex and clones a reference to it.

Returns an owned guard that releases the mutex when dropped.

Examples

use async_mutex::Mutex;
use std::sync::Arc;

let mutex = Arc::new(Mutex::new(10));
let guard = mutex.lock_arc().await;
assert_eq!(*guard, 10);

pub fn try_lock_arc(self: &Arc<Mutex<T>>) -> Option<MutexGuardArc<T>>

Attempts to acquire the mutex and clone a reference to it.

If the mutex could not be acquired at this time, then None is returned. Otherwise, an owned guard is returned that releases the mutex when dropped.

Examples

use async_mutex::Mutex;
use std::sync::Arc;

let mutex = Arc::new(Mutex::new(10));
if let Some(guard) = mutex.try_lock() {
    assert_eq!(*guard, 10);
}

Trait Implementations

impl<T> Debug for Mutex<T>where T: Debug + ?Sized,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<T> Default for Mutex<T>where T: Default + ?Sized,

fn default() -> Mutex<T>

Returns the “default value” for a type.

impl<T> From<T> for Mutex<T>

fn from(val: T) -> Mutex<T>

Converts to this type from the input type.

impl<T> Send for Mutex<T>where T: Send + ?Sized,

impl<T> Sync for Mutex<T>where T: Send + ?Sized,