Struct MutDom 

pub(crate) struct MutDom<T>
where
    T: DomObject,
{
    val: UnsafeCell<Dom<T>>,
}

A holder that provides interior mutability for GC-managed values such as Dom<T>. Essentially a Cell<Dom<T>>, but safer.

This should only be used as a field in other DOM objects; see warning on Dom<T>.

Fields

val: UnsafeCell<Dom<T>>

Implementations

impl<T> MutDom<T>

where T: DomObject,

pub fn new(initial: &T) -> MutDom<T>

Create a new MutDom.

pub fn set(&self, val: &T)

Set this MutDom to the given value.

pub fn get(&self) -> Root<Dom<T>>

Get the value in this MutDom.

pub fn get_unrooted<'a>(&self, _: &'a NoGC) -> UnrootedDom<'a, T>

Get the DomObject without rooting it as an UnrootedDom. This is safe as the return value shares the lifetime of the provided NoGC This implies that while the UnrootedDom is alive, garbage collection will not happen.

pub unsafe fn as_ref_unsafe(&self) -> &Dom<T>

Get a reference to the traced inner value of this MutDom.

Safety

• The caller must not modify the value of the MutDom while the reference is alive.
• The caller must ensure that no garbage collection happens while the reference is alive.

Trait Implementations

impl<T> MallocSizeOf for MutDom<T>

where T: DomObject,

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.

impl<T> PartialEq<T> for MutDom<T>

where T: DomObject + PartialEq,

fn eq(&self, other: &T) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> PartialEq for MutDom<T>

where T: DomObject,

fn eq(&self, other: &MutDom<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'dom, T: DomObject> ToLayout<'dom, T> for MutDom<T>

unsafe fn to_layout(&self) -> LayoutDom<'dom, T>

Get a reference to the contents of this smart pointer as a LayoutDom, for use during layout. Note that this should only be called in the course of layout.

impl<T> Traceable for MutDom<T>

where T: DomObject + Traceable,

unsafe fn trace(&self, tracer: *mut JSTracer)

Trace self.