Struct dharitri_wasm::types::ManagedVec

pub struct ManagedVec<M, T>
where
    M: ManagedTypeApi,
    T: ManagedVecItem<M>,
{ /* private fields */ }

A list of items that lives inside a managed buffer. Items can be either stored there in full (e.g. u32), or just via handle (e.g. BigUint<M>).

Implementations

impl<M, T> ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

pub fn new(api: M) -> Self

impl<M, T> ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

pub fn byte_len(&self) -> usize

Length of the underlying buffer in bytes.

pub fn len(&self) -> usize

Number of items.

pub fn is_empty(&self) -> bool

pub fn get(&self, index: usize) -> Option<T>

Retrieves element at index, if the index is valid. Warning! Ownership around this method is murky, managed items are copied without respecting ownership. TODO: Find a way to fix it by returning some kind of reference to the item, not the owned type.

pub fn slice(&self, start_index: usize, end_index: usize) -> Option<Self>

pub fn push(&mut self, item: T)

pub fn from_single_item(api: M, item: T) -> Self

New ManagedVec instance with 1 element in it.

pub fn overwrite_with_single_item(&mut self, item: T)

pub fn append_vec(&mut self, item: ManagedVec<M, T>)

Appends all the contents of another managed vec at the end of the current one. Consumes the other vec in the process.

pub fn clear(&mut self)

Removes all items while retaining the handle.

pub fn into_vec(self) -> Vec<T>

pub fn with_self_as_vec<F>(&mut self, f: F)

where F: FnOnce(&mut Vec<T>),

Temporarily converts self to a Vec<T>. All operations performed on the temporary vector get saved back to the underlying buffer.

pub fn iter(&self) -> ManagedVecIterator<'_, M, T>

Trait Implementations

impl<M, T> Clone for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + Clone,

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M, T> Debug for ManagedVec<M, T>

where M: ManagedTypeApi + Debug, T: ManagedVecItem<M> + Debug,

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

Formats the value using the given formatter.

impl<M, T> From<&ManagedVec<M, T>> for ManagedMultiResultVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + TopEncode,

fn from(v: &ManagedVec<M, T>) -> Self

Converts to this type from the input type.

impl<M> From<ManagedVec<M, ManagedBuffer<M>>> for ManagedArgBuffer<M>

where M: ManagedTypeApi,

fn from(data: ManagedVec<M, ManagedBuffer<M>>) -> Self

Converts to this type from the input type.

impl<M, T> From<ManagedVec<M, T>> for ManagedCountedMultiResultVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

fn from(v: ManagedVec<M, T>) -> Self

Converts to this type from the input type.

impl<M, T> From<ManagedVec<M, T>> for ManagedMultiResultVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + TopEncode + 'static,

fn from(v: ManagedVec<M, T>) -> Self

Converts to this type from the input type.

impl<M, T> From<ManagedVec<M, T>> for ManagedMultiResultVecEager<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

fn from(managed_vec: ManagedVec<M, T>) -> Self

Converts to this type from the input type.

impl<'a, M, T> IntoIterator for &'a ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

type Item = T

The type of the elements being iterated over.

type IntoIter = ManagedVecIterator<'a, M, T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<M, T> ManagedDefault<M> for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

fn managed_default(api: M) -> Self

impl<M, T, I> ManagedFrom<M, Vec<I>> for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>, I: ManagedInto<M, T>,

fn managed_from(api: M, v: Vec<I>) -> Self

impl<M, T> ManagedType<M> for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

fn type_manager(&self) -> M

impl<M, T> ManagedVecItem<M> for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M>,

const PAYLOAD_SIZE: usize = 4usize

Size of the data stored in the underlying ManagedBuffer.

const SKIPS_RESERIALIZATION: bool = false

If true, then the encoding of the item is identical to the payload, and no further conversion is necessary (the underlying buffer can be used as-is during serialization). False for all managed types, but true for basic types (like u32).

fn from_byte_reader<Reader: FnMut(&mut [u8])>(api: M, reader: Reader) -> Self

fn to_byte_writer<R, Writer: FnMut(&[u8]) -> R>(&self, writer: Writer) -> R

impl<M, T> NestedDecode for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + NestedDecode,

fn dep_decode<I: NestedDecodeInput>(input: &mut I) -> Result<Self, DecodeError>

Attempt to deserialise the value from input, using the format of an object nested inside another structure. In case of success returns the deserialized value and the number of bytes consumed during the operation.

fn dep_decode_or_exit<I, ExitCtx>( input: &mut I, c: ExitCtx, exit: fn(_: ExitCtx, _: DecodeError) -> ! ) -> Self

where I: NestedDecodeInput, ExitCtx: Clone,

Version of top_decode that exits quickly in case of error. Its purpose is to create smaller implementations in cases where the application is supposed to exit directly on decode error.

impl<M, T> NestedEncode for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + NestedEncode,

fn dep_encode<O: NestedEncodeOutput>( &self, dest: &mut O ) -> Result<(), EncodeError>

NestedEncode to output, using the format of an object nested inside another structure. Does not provide compact version.

fn dep_encode_or_exit<O, ExitCtx>( &self, dest: &mut O, c: ExitCtx, exit: fn(_: ExitCtx, _: EncodeError) -> ! )

where O: NestedEncodeOutput, ExitCtx: Clone,

Version of top_decode that exits quickly in case of error. Its purpose is to create smaller implementations in cases where the application is supposed to exit directly on decode error.

impl<M, T> PartialEq for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + PartialEq,

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

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

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.

impl<M, T> TopDecode for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + NestedDecode,

fn top_decode<I: TopDecodeInput>(input: I) -> Result<Self, DecodeError>

Attempt to deserialize the value from input.

fn top_decode_or_exit<I, ExitCtx>( input: I, c: ExitCtx, exit: fn(_: ExitCtx, _: DecodeError) -> ! ) -> Self

where I: TopDecodeInput, ExitCtx: Clone,

Version of top_decode that exits quickly in case of error. Its purpose is to create smaller implementations in cases where the application is supposed to exit directly on decode error.

impl<M, T> TopEncode for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + NestedEncode,

fn top_encode<O: TopEncodeOutput>(&self, output: O) -> Result<(), EncodeError>

Attempt to serialize the value to ouput.

fn top_encode_or_exit<O, ExitCtx>( &self, output: O, c: ExitCtx, exit: fn(_: ExitCtx, _: EncodeError) -> ! )

where O: TopEncodeOutput, ExitCtx: Clone,

Version of top_decode that exits quickly in case of error. Its purpose is to create smaller bytecode implementations in cases where the application is supposed to exit directly on decode error.

impl<M, T> TypeAbi for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + TypeAbi,

fn type_name() -> String

It is semantically equivalent to any list of T.

fn provide_type_descriptions<TDC: TypeDescriptionContainer>( accumulator: &mut TDC )

A type can provide more than its own description. For instance, a struct can also provide the descriptions of the type of its fields. TypeAbi doesn’t care for the exact accumulator type, which is abstracted by the TypeDescriptionContainer trait.

impl<M, T> Eq for ManagedVec<M, T>

where M: ManagedTypeApi, T: ManagedVecItem<M> + PartialEq,