Структура MutexGuard

Создает новый MappedMutexGuard для компонента заблокированных данных.

Эта операция не может завершиться неудачей, поскольку переданный MutexGuard уже заблокировал мьютекс.

Это ассоциированная функция, которую необходимо использовать как MutexGuard::map(...). Метод конфликтовал бы с методами с тем же именем у содержимого заблокированных данных.

Примеры

use tokio::sync::{Mutex, MutexGuard};

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
struct Foo(u32);

let foo = Mutex::new(Foo(1));

{
    let mut mapped = MutexGuard::map(foo.lock().await, |f| &mut f.0);
    *mapped = 2;
}

assert_eq!(Foo(2), *foo.lock().await);

Пытается создать новый MappedMutexGuard для компонента заблокированных данных. Если замыкание возвращает None, возвращается исходный страж.

Эта операция не может завершиться неудачей, поскольку переданный MutexGuard уже заблокировал мьютекс.

Это ассоциированная функция, которую необходимо использовать как MutexGuard::try_map(...). Метод конфликтовал бы с методами с тем же именем у содержимого заблокированных данных.

Примеры

use tokio::sync::{Mutex, MutexGuard};

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
struct Foo(u32);

let foo = Mutex::new(Foo(1));

{
    let mut mapped = MutexGuard::try_map(foo.lock().await, |f| Some(&mut f.0))
        .expect("should not fail");
    *mapped = 2;
}

assert_eq!(Foo(2), *foo.lock().await);

Возвращает ссылку на исходный Mutex.

use tokio::sync::{Mutex, MutexGuard};

async fn unlock_and_relock<'l>(guard: MutexGuard<'l, u32>) -> MutexGuard<'l, u32> {
    println!("1. contains: {:?}", *guard);
    let mutex = MutexGuard::mutex(&guard);
    drop(guard);
    let guard = mutex.lock().await;
    println!("2. contains: {:?}", *guard);
    guard
}

Возвращает аргумент без изменений.

Вызывает U::from(self).

То есть это преобразование выполняет то, что выберет реализация From<T> for U.