Struct script::dom::bindings::cell::DomRefCell

source ·
pub struct DomRefCell<T> {
    value: RefCell<T>,
}
Expand description

A mutable field in the DOM.

This extends the API of std::cell::RefCell to allow unsafe access in certain situations, with dynamic checking in debug builds.

Fields§

§value: RefCell<T>

Implementations§

source§

impl<T> DomRefCell<T>

source

pub unsafe fn borrow_for_layout(&self) -> &T

Return a reference to the contents. For use in layout only.

§Safety

Unlike RefCell::borrow, this method is unsafe because it does not return a Ref, thus leaving the borrow flag untouched. Mutably borrowing the RefCell while the reference returned by this method is alive is undefined behaviour.

§Panics

Panics if this is called from anywhere other than the layout thread

Panics if the value is currently mutably borrowed.

source

pub unsafe fn borrow_for_script_deallocation(&self) -> &mut T

Borrow the contents for the purpose of script deallocation.

§Safety

Unlike RefCell::borrow, this method is unsafe because it does not return a Ref, thus leaving the borrow flag untouched. Mutably borrowing the RefCell while the reference returned by this method is alive is undefined behaviour.

§Panics

Panics if this is called from anywhere other than the script thread.

source

pub unsafe fn borrow_mut_for_layout(&self) -> &mut T

Mutably borrow a cell for layout. Ideally this would use RefCell::try_borrow_mut_unguarded but that doesn’t exist yet.

§Safety

Unlike RefCell::borrow, this method is unsafe because it does not return a Ref, thus leaving the borrow flag untouched. Mutably borrowing the RefCell while the reference returned by this method is alive is undefined behaviour.

§Panics

Panics if this is called from anywhere other than the layout thread.

source§

impl<T> DomRefCell<T>

source

pub fn new(value: T) -> DomRefCell<T>

Create a new DomRefCell containing value.

source

pub fn borrow(&self) -> Ref<'_, T>

Immutably borrows the wrapped value.

The borrow lasts until the returned Ref exits scope. Multiple immutable borrows can be taken out at the same time.

§Panics

Panics if the value is currently mutably borrowed.

source

pub fn borrow_mut(&self) -> RefMut<'_, T>

Mutably borrows the wrapped value.

The borrow lasts until the returned RefMut exits scope. The value cannot be borrowed while this borrow is active.

§Panics

Panics if the value is currently borrowed.

source

pub fn try_borrow(&self) -> Result<Ref<'_, T>, BorrowError>

Attempts to immutably borrow the wrapped value.

The borrow lasts until the returned Ref exits scope. Multiple immutable borrows can be taken out at the same time.

Returns None if the value is currently mutably borrowed.

§Panics

Panics if this is called off the script thread.

source

pub fn try_borrow_mut(&self) -> Result<RefMut<'_, T>, BorrowMutError>

Mutably borrows the wrapped value.

The borrow lasts until the returned RefMut exits scope. The value cannot be borrowed while this borrow is active.

Returns None if the value is currently borrowed.

§Panics

Panics if this is called off the script thread.

Trait Implementations§

source§

impl<T: Clone> Clone for DomRefCell<T>

source§

fn clone(&self) -> DomRefCell<T>

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<T: CustomTraceable> CustomTraceable for DomRefCell<T>

source§

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

Trace self.
source§

impl<T: Debug> Debug for DomRefCell<T>

source§

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

Formats the value using the given formatter. Read more
source§

impl<T: Default> Default for DomRefCell<T>

source§

fn default() -> DomRefCell<T>

Returns the “default value” for a type. Read more
source§

impl<T> MallocSizeOf for DomRefCell<T>
where T: MallocSizeOf,

source§

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.
source§

impl<K, V> Maplike for DomRefCell<IndexMap<K, V>>

§

type Key = K

The type of the key of the map.
§

type Value = V

The type of the value of the map.
source§

fn get_index(&self, index: u32) -> Option<(Self::Key, Self::Value)>

source§

fn get(&self, key: Self::Key) -> Option<Self::Value>

source§

fn size(&self) -> u32

source§

fn set(&self, key: Self::Key, value: Self::Value)

source§

fn has(&self, key: Self::Key) -> bool

source§

fn clear(&self)

source§

fn delete(&self, key: Self::Key) -> bool

source§

impl<T: PartialEq> PartialEq for DomRefCell<T>

source§

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

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<K> Setlike for DomRefCell<IndexSet<K>>

§

type Key = K

The type of the key of the set.
source§

fn get_index(&self, index: u32) -> Option<Self::Key>

source§

fn size(&self) -> u32

source§

fn add(&self, key: Self::Key)

source§

fn has(&self, key: Self::Key) -> bool

source§

fn clear(&self)

source§

fn delete(&self, key: Self::Key) -> bool

source§

impl<T: JSTraceable> Traceable for DomRefCell<T>

source§

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

Trace self.
source§

impl<T> StructuralPartialEq for DomRefCell<T>

Auto Trait Implementations§

§

impl<T> !Freeze for DomRefCell<T>

§

impl<T> !RefUnwindSafe for DomRefCell<T>

§

impl<T> Send for DomRefCell<T>
where T: Send,

§

impl<T> !Sync for DomRefCell<T>

§

impl<T> Unpin for DomRefCell<T>
where T: Unpin,

§

impl<T> UnwindSafe for DomRefCell<T>
where T: UnwindSafe,

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Downcast<T> for T

source§

fn downcast(&self) -> &T

source§

impl<T> Filterable for T

source§

fn filterable( self, filter_name: &'static str, ) -> RequestFilterDataProvider<T, fn(_: DataRequest<'_>) -> bool>

Creates a filterable data provider with the given name for debugging. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> IntoEither for T

source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
source§

impl<T> MaybeBoxed<Box<T>> for T

source§

fn maybe_boxed(self) -> Box<T>

Convert
source§

impl<T> MaybeBoxed<T> for T

source§

fn maybe_boxed(self) -> T

Convert
source§

impl<T> Pointable for T

source§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<R, P> ReadPrimitive<R> for P
where R: Read + ReadEndian<P>, P: Default,

source§

fn read_from_little_endian(read: &mut R) -> Result<Self, Error>

Read this value from the supplied reader. Same as ReadEndian::read_from_little_endian().
source§

fn read_from_big_endian(read: &mut R) -> Result<Self, Error>

Read this value from the supplied reader. Same as ReadEndian::read_from_big_endian().
source§

fn read_from_native_endian(read: &mut R) -> Result<Self, Error>

Read this value from the supplied reader. Same as ReadEndian::read_from_native_endian().
source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> Upcast<T> for T

source§

fn upcast(&self) -> Option<&T>

source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

source§

fn vzip(self) -> V

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<T> ErasedDestructor for T
where T: 'static,

source§

impl<T> MaybeSendSync for T

source§

impl<T> WasmNotSend for T
where T: Send,