Struct style::shared_lock::SharedRwLock

pub struct SharedRwLock {
    arc: Arc<RwLock<()>>,
}

A shared read/write lock that can protect multiple objects.

In Gecko builds, we don’t need the blocking behavior, just the safety. As such we implement this with an AtomicRefCell instead in Gecko builds, which is ~2x as fast, and panics (rather than deadlocking) when things go wrong (which is much easier to debug on CI).

Servo needs the blocking behavior for its unsynchronized animation setup, but that may not be web-compatible and may need to be changed (at which point Servo could use AtomicRefCell too).

Gecko also needs the ability to have “read only” SharedRwLocks, which are used for objects stored in (read only) shared memory. Attempting to acquire write access to objects protected by a read only SharedRwLock will panic.

Fields

arc: Arc<RwLock<()>>

Implementations

impl SharedRwLock

pub fn new() -> Self

Create a new shared lock (servo).

pub fn new_leaked() -> Self

Create a new global shared lock (servo).

pub fn wrap<T>(&self, data: T) -> Locked<T>

Wrap the given data to make its access protected by this lock.

pub fn read(&self) -> SharedRwLockReadGuard<'_>

Obtain the lock for reading (servo).

pub fn write(&self) -> SharedRwLockWriteGuard<'_>

Obtain the lock for writing (servo).

Trait Implementations

impl Clone for SharedRwLock

fn clone(&self) -> SharedRwLock

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SharedRwLock

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

Formats the value using the given formatter.

impl MallocSizeOf for SharedRwLock

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.