Struct elrond_wasm::types::ManagedVec

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

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, 

pub fn new() -> Self

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

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 set(&mut self, index: usize, item: &T) -> Result<(), InvalidSliceError>

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

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

pub fn from_single_item(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<R, F>(&mut self, f: F) -> R where
    F: FnOnce(&mut Vec<T>) -> R, 

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 + 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,
    T: ManagedVecItem + Debug + Clone, 

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

Formats the value using the given formatter.

impl<M, T> Default for ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem, 

fn default() -> Self

Returns the “default value” for a type.

impl<M, T> From<&'_ ManagedVec<M, T>> for ManagedMultiResultVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem + TopEncode, 

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

Performs the conversion.

impl<M> From<ManagedVec<M, ManagedBuffer<M>>> for ManagedArgBuffer<M> where
    M: ManagedTypeApi, 

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

Performs the conversion.

impl<M, T> From<ManagedVec<M, T>> for ManagedMultiResultVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem + TopEncode + 'static, 

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

Performs the conversion.

impl<M, T> From<ManagedVec<M, T>> for ManagedCountedMultiResultVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem, 

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

Performs the conversion.

impl<M, T> From<ManagedVec<M, T>> for ManagedMultiResultVecEager<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem, 

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

Performs the conversion.

impl<M, T, I> From<Vec<I, Global>> for ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem,
    I: Into<T>, 

fn from(v: Vec<I>) -> Self

Performs the conversion.

impl<'a, M, T> IntoIterator for &'a ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem, 

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> ManagedType<M> for ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem, 

fn type_manager(&self) -> M

impl<M, T> ManagedVecItem for ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem, 

const PAYLOAD_SIZE: usize

Size of the data stored in the underlying ManagedBuffer.

const SKIPS_RESERIALIZATION: bool

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])>(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 + 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 + 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<ManagedVec<M, T>> for ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem + 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 !=.

impl<M, T> TopDecode for ManagedVec<M, T> where
    M: ManagedTypeApi,
    T: ManagedVecItem + 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 + 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 + 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 + PartialEq,