Struct OwnedTree

pub struct OwnedTree { /* private fields */ }

An owned version of a Tree containing the HTML data used to build it.

This structure uses self_cell to build a self-referencing structure without a lifetime.

Implementations

impl OwnedTree

pub fn new( owner: String, dependent_builder: impl for<'_q> FnOnce(&'_q String) -> Tree<'_q>, ) -> Self

Constructs a new self-referential struct.

The provided owner will be moved into a heap allocated box. Followed by construction of the dependent value, by calling dependent_builder with a shared reference to the owner that remains valid for the lifetime of the constructed struct.

pub fn try_new<Err>( owner: String, dependent_builder: impl for<'_q> FnOnce(&'_q String) -> Result<Tree<'_q>, Err>, ) -> Result<Self, Err>

Constructs a new self-referential struct or returns an error.

Consumes owner on error.

pub fn try_new_or_recover<Err>( owner: String, dependent_builder: impl for<'_q> FnOnce(&'_q String) -> Result<Tree<'_q>, Err>, ) -> Result<Self, (String, Err)>

Constructs a new self-referential struct or returns an error.

Returns owner and error as tuple on error.

pub fn borrow_owner<'_q>(&'_q self) -> &'_q String

Borrows owner.

pub fn with_dependent<'outer_fn, Ret>( &'outer_fn self, func: impl for<'_q> FnOnce(&'_q String, &'outer_fn Tree<'_q>) -> Ret, ) -> Ret

Calls given closure func with a shared reference to dependent.

pub fn with_dependent_mut<'outer_fn, Ret>( &'outer_fn mut self, func: impl for<'_q> FnOnce(&'_q String, &'outer_fn mut Tree<'_q>) -> Ret, ) -> Ret

Calls given closure func with an unique reference to dependent.

pub fn borrow_dependent<'_q>(&'_q self) -> &'_q Tree<'_q>

Borrows dependent.

pub fn into_owner(self) -> String

Consumes self and returns the the owner.

impl OwnedTree

pub fn get_data(&self) -> &str

Get the inner HTML of the tree.

pub fn get_tree(&self) -> &Tree<'_>

Get an immutable reference to the inner tree.

pub fn mutate<Return>( &mut self, func: impl FnOnce(&mut Tree<'_>) -> Return, ) -> Return

Mutate the tree temporarily by executing the given function.

Trait Implementations

impl Debug for OwnedTree

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

Formats the value using the given formatter.

impl Drop for OwnedTree

fn drop(&mut self)

Executes the destructor for this type.