Struct Lazy

pub struct Lazy<T, const EXOTIC: bool = false> { /* private fields */ }

Lazy-loaded model.

Implementations

impl<T, const EXOTIC: bool> Lazy<T, EXOTIC>

pub fn from_raw(cell: Cell) -> Result<Self, Error>

Wraps the cell in a typed wrapper.

pub unsafe fn from_raw_unchecked(cell: Cell) -> Self

Wraps the cell in a typed wrapper.

Safety

The cell is_exotic flag must be in sync with EXOTIC type param.

pub fn into_inner(self) -> Cell

Converts into the underlying cell.

pub fn inner(&self) -> &Cell

Returns the underlying cell.

pub fn cast_into<Q>(self) -> Lazy<Q, EXOTIC>

where Q: EquivalentRepr<T>,

Converts into a lazy loader for an equivalent type.

pub fn cast_ref<Q>(&self) -> &Lazy<Q, EXOTIC>

where Q: EquivalentRepr<T>,

Casts itself into a lazy loaded for an equivalent type.

pub fn serialize_repr_hash<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serializes only the root hash of the cell.

impl<T: Store, const EXOTIC: bool> Lazy<T, EXOTIC>

pub fn new(data: &T) -> Result<Self, Error>

Serializes the provided data and returns the typed wrapper around it.

pub fn set(&mut self, data: &T) -> Result<(), Error>

Updates the content with the provided data.

impl<'a, T: Load<'a> + 'a> Lazy<T, false>

pub fn load(&'a self) -> Result<T, Error>

Loads inner data from cell expecting an ordinary cell.

impl<'a, T: LoadCell<'a> + 'a> Lazy<T, true>

pub fn load(&'a self) -> Result<T, Error>

Loads inner data from cell expecting an exotic cell.

Methods from Deref<Target = DynCell>

pub fn cell_type(&self) -> CellType

Computes cell type from descriptor bytes.

pub fn level(&self) -> u8

Computes the cell level from the level mask.

pub fn level_mask(&self) -> LevelMask

Computes the level mask from the descriptor bytes.

pub fn reference_count(&self) -> u8

Computes the number of child cells from descriptor bytes.

pub fn get_reference_as_slice(&self, index: u8) -> Result<CellSlice<'_>, Error>

Tries to load the specified child cell as slice. Returns an error if the loaded cell is absent or is pruned.

pub fn is_exotic(&self) -> bool

Returns whether the cell is not Ordinary.

pub fn repr_hash(&self) -> &HashBytes

Returns a representation hash of the cell.

pub fn repr_depth(&self) -> u16

Returns a representation depth of the cell.

pub fn has_max_depth(&self) -> bool

Returns true if any of cell levels has the maximum depth.

pub fn is_empty(&self) -> bool

Returns true if the cell is empty (no bits, no refs).

pub fn references(&self) -> RefsIter<'_>

Creates an iterator through child nodes.

pub fn as_slice(&self) -> Result<CellSlice<'_>, Error>

Returns this cell as a cell slice. Returns an error if the cell is not ordinary.

pub fn as_slice_allow_exotic(&self) -> CellSlice<'_>

Returns this cell as a cell slice.

Loads cell as is.

pub fn compute_unique_stats(&self, limit: usize) -> Option<CellTreeStats>

Recursively computes the count of distinct cells returning the total storage used by this dag taking into account the identification of equal cells.

pub fn touch_recursive(&self)

Recursively traverses the cells tree without tracking a uniqueness of cells. Usefull for adding small subtrees to merkle proofs.

pub fn debug_root(&self) -> DebugCell<'_>

Returns an object that implements Debug for printing only the root cell of the cell tree.

pub fn display_root(&self) -> DisplayCellRoot<'_>

Returns an object that implements Display for printing only the root cell of the cell tree.

pub fn display_tree(&self) -> DisplayCellTree<'_>

Returns an object that implements Display for printing all cells in the cell tree.

pub fn display_data(&self) -> impl Display + Binary + '_

Returns an object which will display cell data as a bitstring with a termination bit.

pub fn parse<'a, T: Load<'a>>(&'a self) -> Result<T, Error>

Converts this cell into a slice and tries to load the specified type from it. Fails if the cell is not ordinary.

NOTE: parsing Cell will load the first reference!

pub fn parse_exotic<'a, T: LoadCell<'a>>(&'a self) -> Result<T, Error>

Loads an exotic cell.

Trait Implementations

impl<T, const EXOTIC: bool> AsRef<dyn CellImpl + Sync + Send> for Lazy<T, EXOTIC>

fn as_ref(&self) -> &DynCell

Converts this type into a shared reference of the (usually inferred) input type.

impl<T, const EXOTIC: bool> Clone for Lazy<T, EXOTIC>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for Lazy<T, false>

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

Formats the value using the given formatter.

impl<T> Debug for Lazy<T, true>

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

Formats the value using the given formatter.

impl<T, const EXOTIC: bool> Deref for Lazy<T, EXOTIC>

type Target = Cell

The resulting type after dereferencing.

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

Dereferences the value.

impl<'de, T, const EXOTIC: bool> Deserialize<'de> for Lazy<T, EXOTIC>

where T: Deserialize<'de> + Store,

fn deserialize<D>(deserializer: D) -> Result<Lazy<T, EXOTIC>, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T, const EXOTIC: bool> ExactSize for Lazy<T, EXOTIC>

fn exact_size(&self) -> Size

Exact size of the value when it is stored in a slice.

impl<'a, T, const EXOTIC: bool> Load<'a> for Lazy<T, EXOTIC>

fn load_from(slice: &mut CellSlice<'a>) -> Result<Self, Error>

Tries to load itself from a cell slice.

impl<T, const EXOTIC: bool> PartialEq<&Cell> for Lazy<T, EXOTIC>

fn eq(&self, other: &&Cell) -> bool

Tests for self and other values to be equal, and is used by ==.

const 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<T, const EXOTIC: bool> PartialEq<&Lazy<T, EXOTIC>> for Cell

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

Tests for self and other values to be equal, and is used by ==.

const 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<T, const EXOTIC: bool> PartialEq<Cell> for Lazy<T, EXOTIC>

fn eq(&self, other: &Cell) -> bool

Tests for self and other values to be equal, and is used by ==.

const 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<T, const EXOTIC: bool> PartialEq<Lazy<T, EXOTIC>> for Cell

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

Tests for self and other values to be equal, and is used by ==.

const 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<T, const EXOTIC: bool> PartialEq for Lazy<T, EXOTIC>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

const 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<T> Serialize for Lazy<T, false>

where for<'a> T: Serialize + Load<'a>,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> Serialize for Lazy<T, true>

where for<'a> T: Serialize + LoadCell<'a>,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T, const EXOTIC: bool> Store for Lazy<T, EXOTIC>

fn store_into( &self, builder: &mut CellBuilder, _: &dyn CellContext, ) -> Result<(), Error>

Tries to store itself into the cell builder.

impl<T: WithAbiType> WithAbiType for Lazy<T>

fn abi_type() -> AbiType

Returns a corresponding ABI type.

impl<T, const EXOTIC: bool> Eq for Lazy<T, EXOTIC>