Struct UnrootedDom 

pub struct UnrootedDom<'a, T: DomObject> {
    inner: Dom<T>,
    _phantom: PhantomData<&'a ()>,
}

A reference to a DomObject that can live on the stack unrooted by having it inherit the lifetime of a NoGC, which is a token that ensures that garbage collection will not happen.

Fields

inner: Dom<T>

_phantom: PhantomData<&'a ()>

Implementations

impl<'a, T: DomObject> UnrootedDom<'a, T>

pub fn from_dom(object: Dom<T>, _no_gc: &'a NoGC) -> UnrootedDom<'a, T>

Construct an UnrootedDom with the lifetime of the given NoGC token. It is safe to keep the returned value on the stack as it cannot outlive the lifetime of the token and the token should ensure that no garbage collection will take place as long as it is alive.

impl<'a, T: Castable> UnrootedDom<'a, T>

pub fn upcast<U>(dom: UnrootedDom<'a, T>) -> UnrootedDom<'a, U>

where U: Castable, T: DerivedFrom<U>,

Cast a DOM object root upwards to one of the interfaces it derives from.

pub fn downcast<U>(dom: UnrootedDom<'a, T>) -> Option<UnrootedDom<'a, U>>

where U: DerivedFrom<T>,

Cast a DOM object root downwards to one of the interfaces it might implement.

Methods from Deref<Target = Dom<T>>

pub fn as_rooted(&self) -> DomRoot<T>

Return a rooted version of this DOM object (DomRoot<T>) suitable for use on the stack.

pub fn as_ptr(&self) -> *const T

Trait Implementations

impl<'a, T: DomObject> Clone for UnrootedDom<'a, T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, T: DomObject + Debug> Debug for UnrootedDom<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: DomObject> Deref for UnrootedDom<'a, T>

type Target = Dom<T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a, T: DomObject> PartialEq<T> for UnrootedDom<'a, T>

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<'a, T: DomObject> PartialEq for UnrootedDom<'a, T>

fn eq(&self, other: &UnrootedDom<'a, 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.