Struct Mut 

pub struct Mut<'host> { /* private fields */ }

A mutable reference to an espy value.

espy does not have inherited mutability, only interior mutability. This means that Mut contains a RefCell.

Only the original Mut contains a strong Rc to its contained value; any time the mutable reference is copied the copy is instead a weak reference. This prevents reference cycles from being constructed by espy programs to leak memory. However, Mut::upgrade is provided for hosts to upgrade weak references into strong ones should the need arise.

Implementations

impl<'host> Mut<'host>

pub fn new(rc: Rc<RefCell<Value<'host>>>) -> Self

pub fn upgrade(&self) -> Option<Rc<RefCell<Value<'host>>>>

Creates a strong reference to the mutable reference’s origin if it still exists.

This can be used to create reference cycles and leak memory, so it should only be exposed to trusted espy programs.

Trait Implementations

impl Clone for Mut<'_>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'host> Debug for Mut<'host>

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

Formats the value using the given formatter.