结构体 RwLockMappedWriteGuard 

pub struct RwLockMappedWriteGuard<'a, T: ?Sized> { /* 私有字段 */ }

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

此结构体通过对 RwLockWriteGuard 进行 映射 创建。它是与 RwLockWriteGuard 分开的类型，因为降级映射后的 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，则返回原始守卫。

此操作不会失败，因为传入的 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,