结构体 RwLockMappedWriteGuard 

pub struct RwLockMappedWriteGuard<'a, T: ?Sized> { /* private fields */ }

RAII 结构，在 drop 时释放锁的独占写访问。

此结构体 通过对 RwLockWriteGuard 进行 map 创建。 它是 一个 与 RwLockWriteGuard 不同的类型， 以禁止 对已 map 的 guard 进行降级， 因为 这样做 可能会 导致未定义行为。

实现

impl<'a, T: ?Sized> RwLockMappedWriteGuard<'a, T>

pub fn map<F, U: ?Sized>(this: Self, f: F) -> RwLockMappedWriteGuard<'a, U>

where F: FnOnce(&mut T) -> &mut U,

为已锁定数据的一个组件创建一个新的 RwLockMappedWriteGuard。

该操作不会失败，因为传入的 RwLockMappedWriteGuard 已经锁定了这些数据。

这是一个关联函数，需要作为 RwLockMappedWriteGuard::map(..) 使用。如果使用方法会和已锁定数据内容器上同名的方法冲突。

这是 parking_lot crate 中 RwLockWriteGuard::map 的异步版本。

示例

use tokio::sync::{RwLock, RwLockWriteGuard};



#[derive(Debug, Clone, Copy, PartialEq, Eq)]

struct Foo(u32);



let lock = RwLock::new(Foo(1));



{

    let mut mapped = RwLockWriteGuard::map(lock.write().await, |f| &mut f.0);

    *mapped = 2;

}



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

pub fn try_map<F, U: ?Sized>( this: Self, f: F, ) -> Result<RwLockMappedWriteGuard<'a, U>, Self>

where F: FnOnce(&mut T) -> Option<&mut U>,

尝试为已锁定数据的一个组件创建一个新的 RwLockMappedWriteGuard。如果闭包返回 None，则返回原始 guard。

该操作不会失败，因为传入的 RwLockMappedWriteGuard 已经锁定了这些数据。

这是一个关联函数，需要作为 RwLockMappedWriteGuard::try_map(...) 使用。如果用方法会和已锁定数据内容器上同名的方法冲突。

这是 parking_lot crate 中 RwLockWriteGuard::try_map 的异步版本。

示例

use tokio::sync::{RwLock, RwLockWriteGuard};



#[derive(Debug, Clone, Copy, PartialEq, Eq)]

struct Foo(u32);



let lock = RwLock::new(Foo(1));



{

    let guard = lock.write().await;

    let mut guard = RwLockWriteGuard::try_map(guard, |f| Some(&mut f.0)).expect("should not fail");

    *guard = 2;

}



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

Trait 实现

impl<'a, T> Debug for RwLockMappedWriteGuard<'a, T>

where T: Debug + ?Sized,

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

使用给定的格式化器格式化此值。 更多信息

impl<T: ?Sized> Deref for RwLockMappedWriteGuard<'_, T>

type Target = T

解引用后得到的类型。

fn deref(&self) -> &T

解引用此值。

impl<T: ?Sized> DerefMut for RwLockMappedWriteGuard<'_, T>

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

以可变方式解引用此值。

impl<'a, T> Display for RwLockMappedWriteGuard<'a, T>

where T: Display + ?Sized,

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

使用给定的格式化器格式化此值。 更多信息

impl<'a, T: ?Sized> Drop for RwLockMappedWriteGuard<'a, T>

fn drop(&mut self)

执行此类型的析构函数。 更多信息

impl<T> Send for RwLockMappedWriteGuard<'_, T>

where T: ?Sized + Send + Sync,

impl<T> Sync for RwLockMappedWriteGuard<'_, T>

where T: ?Sized + Send + Sync,