use std::fmt::{Debug, Display}; use std::hash::Hash; use std::marker::PhantomData; use std::ops::{Deref, DerefMut}; use lock_api::RawRwLock; use crate::lockable::RawLock; use crate::ThreadKey; use super::{RwLock, RwLockWriteGuard, RwLockWriteRef}; // These impls make things slightly easier because now you can use // `println!("{guard}")` instead of `println!("{}", *guard)` #[mutants::skip] // hashing involves PRNG and is difficult to test #[cfg(not(tarpaulin_include))] impl Hash for RwLockWriteRef<'_, T, R> { fn hash(&self, state: &mut H) { self.deref().hash(state) } } #[mutants::skip] #[cfg(not(tarpaulin_include))] impl Debug for RwLockWriteRef<'_, T, R> { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { Debug::fmt(&**self, f) } } impl Display for RwLockWriteRef<'_, T, R> { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { Display::fmt(&**self, f) } } impl Deref for RwLockWriteRef<'_, T, R> { type Target = T; fn deref(&self) -> &Self::Target { // safety: this is the only type that can use `value`, and there's // a reference to this type, so there cannot be any mutable // references to this value. unsafe { &*self.0.data.get() } } } impl DerefMut for RwLockWriteRef<'_, T, R> { fn deref_mut(&mut self) -> &mut Self::Target { // safety: this is the only type that can use `value`, and we have a // mutable reference to this type, so there cannot be any other // references to this value. unsafe { &mut *self.0.data.get() } } } impl AsRef for RwLockWriteRef<'_, T, R> { fn as_ref(&self) -> &T { self } } impl AsMut for RwLockWriteRef<'_, T, R> { fn as_mut(&mut self) -> &mut T { self } } impl Drop for RwLockWriteRef<'_, T, R> { fn drop(&mut self) { // safety: this guard is being destroyed, so the data cannot be // accessed without locking again unsafe { self.0.raw_unlock_write() } } } impl<'a, T: ?Sized + 'a, R: RawRwLock> RwLockWriteRef<'a, T, R> { /// Creates a reference to the underlying data of an [`RwLock`] without /// locking or taking ownership of the key. #[must_use] pub(crate) const unsafe fn new(mutex: &'a RwLock) -> Self { Self(mutex, PhantomData) } } #[mutants::skip] // hashing involves PRNG and is difficult to test #[cfg(not(tarpaulin_include))] impl Hash for RwLockWriteGuard<'_, T, R> { fn hash(&self, state: &mut H) { self.deref().hash(state) } } #[mutants::skip] #[cfg(not(tarpaulin_include))] impl Debug for RwLockWriteGuard<'_, T, R> { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { Debug::fmt(&**self, f) } } impl Display for RwLockWriteGuard<'_, T, R> { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { Display::fmt(&**self, f) } } impl Deref for RwLockWriteGuard<'_, T, R> { type Target = T; fn deref(&self) -> &Self::Target { &self.rwlock } } impl DerefMut for RwLockWriteGuard<'_, T, R> { fn deref_mut(&mut self) -> &mut Self::Target { &mut self.rwlock } } impl AsRef for RwLockWriteGuard<'_, T, R> { fn as_ref(&self) -> &T { self } } impl AsMut for RwLockWriteGuard<'_, T, R> { fn as_mut(&mut self) -> &mut T { self } } impl<'a, T: ?Sized + 'a, R: RawRwLock> RwLockWriteGuard<'a, T, R> { /// Create a guard to the given mutex. Undefined if multiple guards to the /// same mutex exist at once. #[must_use] pub(super) const unsafe fn new(rwlock: &'a RwLock, thread_key: ThreadKey) -> Self { Self { rwlock: RwLockWriteRef(rwlock, PhantomData), thread_key, } } } unsafe impl Sync for RwLockWriteRef<'_, T, R> {}