Struct boa_gc::RefMut

pub struct RefMut<'a, T, U = T>where
    T: 'static + Trace + ?Sized,
    U: ?Sized,{ /* private fields */ }

A wrapper type for a mutably borrowed value from a GcCell<T>.

Implementations

impl<'a, T, U> GcCellRefMut<'a, T, U>where
    T: Trace + ?Sized,
    U: ?Sized,

pub fn map<V, F>(orig: GcCellRefMut<'a, T, U>, f: F) -> GcCellRefMut<'a, T, V>where
    F: FnOnce(&mut U) -> &mut V,
    V: ?Sized,

Makes a new GcCellRefMut for a component of the borrowed data, e.g., an enum variant.

The GcCellRefMut is already mutably borrowed, so this cannot fail.

This is an associated function that needs to be used as GcCellRefMut::map(...). A method would interfere with methods of the same name on the contents of a GcCell used through Deref.

Examples

use gc::{GcCell, GcCellRefMut};

let c = GcCell::new((5, 'b'));
{
    let b1: GcCellRefMut<(u32, char)> = c.borrow_mut();
    let mut b2: GcCellRefMut<(u32, char), u32> = GcCellRefMut::map(b1, |t| &mut t.0);
    assert_eq!(*b2, 5);
    *b2 = 42;
}
assert_eq!(*c.borrow(), (42, 'b'));

Trait Implementations

impl<'a, T, U> Debug for GcCellRefMut<'a, T, U>where
    T: Trace + ?Sized,
    U: Debug + ?Sized,

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

Formats the value using the given formatter.

impl<'a, T, U> Deref for GcCellRefMut<'a, T, U>where
    T: Trace + ?Sized,
    U: ?Sized,

type Target = U

The resulting type after dereferencing.

fn deref(&self) -> &U

Dereferences the value.

impl<'a, T, U> DerefMut for GcCellRefMut<'a, T, U>where
    T: Trace + ?Sized,
    U: ?Sized,

fn deref_mut(&mut self) -> &mut U

Mutably dereferences the value.

impl<'a, T, U> Display for GcCellRefMut<'a, T, U>where
    T: Trace + ?Sized,
    U: Display + ?Sized,

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

Formats the value using the given formatter.

impl<'a, T, U> Drop for GcCellRefMut<'a, T, U>where
    T: Trace + ?Sized,
    U: ?Sized,

fn drop(&mut self)

Executes the destructor for this type.