use crate::sync::rwlock::RwLock; use std::fmt; use std::marker::PhantomData; use std::mem::{self, ManuallyDrop}; use std::ops; use std::sync::Arc; /// Owned RAII structure used to release the exclusive write access of a lock when /// dropped. /// /// This structure is created by [mapping] an [`OwnedRwLockWriteGuard`]. It is a /// separate type from `OwnedRwLockWriteGuard` to disallow downgrading a mapped /// guard, since doing so can cause undefined behavior. /// /// [mapping]: method@crate::sync::OwnedRwLockWriteGuard::map /// [`OwnedRwLockWriteGuard`]: struct@crate::sync::OwnedRwLockWriteGuard pub struct OwnedRwLockMappedWriteGuard { pub(super) permits_acquired: u32, // ManuallyDrop allows us to destructure into this field without running the destructor. pub(super) lock: ManuallyDrop>>, pub(super) data: *mut U, pub(super) _p: PhantomData, } impl OwnedRwLockMappedWriteGuard { /// Make a new `OwnedRwLockMappedWriteGuard` for a component of the locked /// data. /// /// This operation cannot fail as the `OwnedRwLockMappedWriteGuard` passed /// in already locked the data. /// /// This is an associated function that needs to be used as /// `OwnedRwLockWriteGuard::map(..)`. A method would interfere with methods /// of the same name on the contents of the locked data. /// /// # Examples /// /// ``` /// use std::sync::Arc; /// use tokio::sync::{RwLock, OwnedRwLockWriteGuard}; /// /// #[derive(Debug, Clone, Copy, PartialEq, Eq)] /// struct Foo(u32); /// /// # #[tokio::main] /// # async fn main() { /// let lock = Arc::new(RwLock::new(Foo(1))); /// /// { /// let lock = Arc::clone(&lock); /// let mut mapped = OwnedRwLockWriteGuard::map(lock.write_owned().await, |f| &mut f.0); /// *mapped = 2; /// } /// /// assert_eq!(Foo(2), *lock.read().await); /// # } /// ``` #[inline] pub fn map(mut this: Self, f: F) -> OwnedRwLockMappedWriteGuard where F: FnOnce(&mut U) -> &mut V, { let data = f(&mut *this) as *mut V; let lock = unsafe { ManuallyDrop::take(&mut this.lock) }; let permits_acquired = this.permits_acquired; // NB: Forget to avoid drop impl from being called. mem::forget(this); OwnedRwLockMappedWriteGuard { permits_acquired, lock: ManuallyDrop::new(lock), data, _p: PhantomData, } } /// Attempts to make a new `OwnedRwLockMappedWriteGuard` for a component /// of the locked data. The original guard is returned if the closure /// returns `None`. /// /// This operation cannot fail as the `OwnedRwLockMappedWriteGuard` passed /// in already locked the data. /// /// This is an associated function that needs to be /// used as `OwnedRwLockMappedWriteGuard::try_map(...)`. A method would interfere with /// methods of the same name on the contents of the locked data. /// /// # Examples /// /// ``` /// use std::sync::Arc; /// use tokio::sync::{RwLock, OwnedRwLockWriteGuard}; /// /// #[derive(Debug, Clone, Copy, PartialEq, Eq)] /// struct Foo(u32); /// /// # #[tokio::main] /// # async fn main() { /// let lock = Arc::new(RwLock::new(Foo(1))); /// /// { /// let guard = Arc::clone(&lock).write_owned().await; /// let mut guard = OwnedRwLockWriteGuard::try_map(guard, |f| Some(&mut f.0)).expect("should not fail"); /// *guard = 2; /// } /// /// assert_eq!(Foo(2), *lock.read().await); /// # } /// ``` #[inline] pub fn try_map( mut this: Self, f: F, ) -> Result, Self> where F: FnOnce(&mut U) -> Option<&mut V>, { let data = match f(&mut *this) { Some(data) => data as *mut V, None => return Err(this), }; let lock = unsafe { ManuallyDrop::take(&mut this.lock) }; let permits_acquired = this.permits_acquired; // NB: Forget to avoid drop impl from being called. mem::forget(this); Ok(OwnedRwLockMappedWriteGuard { permits_acquired, lock: ManuallyDrop::new(lock), data, _p: PhantomData, }) } } impl ops::Deref for OwnedRwLockMappedWriteGuard { type Target = U; fn deref(&self) -> &U { unsafe { &*self.data } } } impl ops::DerefMut for OwnedRwLockMappedWriteGuard { fn deref_mut(&mut self) -> &mut U { unsafe { &mut *self.data } } } impl fmt::Debug for OwnedRwLockMappedWriteGuard where U: fmt::Debug, { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { fmt::Debug::fmt(&**self, f) } } impl fmt::Display for OwnedRwLockMappedWriteGuard where U: fmt::Display, { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { fmt::Display::fmt(&**self, f) } } impl Drop for OwnedRwLockMappedWriteGuard { fn drop(&mut self) { self.lock.s.release(self.permits_acquired as usize); unsafe { ManuallyDrop::drop(&mut self.lock) }; } }