Trait multiversx_sc::types::ManagedVecItem

pub trait ManagedVecItem: 'static {
    type Ref<'a>: Borrow<Self>;

    const PAYLOAD_SIZE: usize;
    const SKIPS_RESERIALIZATION: bool;

    // Required methods
    fn from_byte_reader<Reader: FnMut(&mut [u8])>(reader: Reader) -> Self;
    unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>(
        reader: Reader
    ) -> Self::Ref<'a>;
    fn to_byte_writer<R, Writer: FnMut(&[u8]) -> R>(&self, writer: Writer) -> R;
}

Types that implement this trait can be items inside a ManagedVec. All these types need a payload, i.e a representation that gets stored in the underlying managed buffer. Not all data needs to be stored as payload, for instance for most managed types the payload is just the handle, whereas the mai ndata is kept by the VM.

Required Associated Types

type Ref<'a>: Borrow<Self>

Reference representation of the ManagedVec item.

Implementations:

• For items with Copy semantics, it should be the type itself.
• For managed types, ManagedRef does the job.
• For any other types, Self is currently used, although this is technically unsafe. TODO: wrap other types in readonly wrapper.

Required Associated Constants

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).

Required Methods

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

Parses given bytes as a an owned object.

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

Parses given bytes as a representation of the object, either owned, or a reference.

Safety

In certain cases this involves practically disregarding the lifetimes, hence it is unsafe.

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

Implementations on Foreign Types

impl ManagedVecItem for bool

const PAYLOAD_SIZE: usize = 1usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = bool

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for i32

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = i32

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for u8

const PAYLOAD_SIZE: usize = 1usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = u8

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for u32

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = u32

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for i64

const PAYLOAD_SIZE: usize = 8usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = i64

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl<T> ManagedVecItem for Option<T>where T: ManagedVecItem,

const PAYLOAD_SIZE: usize = _

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = Option<T>

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for u64

const PAYLOAD_SIZE: usize = 8usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = u64

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl<T, const N: usize> ManagedVecItem for [T; N]where T: ManagedVecItem,

const PAYLOAD_SIZE: usize = _

const SKIPS_RESERIALIZATION: bool = T::SKIPS_RESERIALIZATION

type Ref<'a> = [T; N]

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for u16

const PAYLOAD_SIZE: usize = 2usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = u16

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

impl ManagedVecItem for usize

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = true

type Ref<'a> = usize

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

unsafe fn from_byte_reader_as_borrow<'a, Reader: FnMut(&mut [u8])>( reader: Reader ) -> Self::Ref<'a>

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

Implementors

impl ManagedVecItem for EsdtLocalRole

const PAYLOAD_SIZE: usize = 1usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = EsdtLocalRole

impl<M, T> ManagedVecItem for ManagedOption<M, T>where M: ManagedTypeApi, T: ManagedType<M> + 'static,

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedOption<M, T>

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

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, ManagedVec<M, T>>

impl<M, const N: usize> ManagedVecItem for ManagedByteArray<M, N>where M: ManagedTypeApi,

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, ManagedByteArray<M, N>>

impl<M: ManagedTypeApi> ManagedVecItem for BigInt<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, BigInt<M>>

impl<M: ManagedTypeApi> ManagedVecItem for BigUint<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, BigUint<M>>

impl<M: ManagedTypeApi> ManagedVecItem for EgldOrEsdtTokenIdentifier<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = EgldOrEsdtTokenIdentifier<M>

impl<M: ManagedTypeApi> ManagedVecItem for EllipticCurve<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, EllipticCurve<M>>

impl<M: ManagedTypeApi> ManagedVecItem for EsdtTokenPayment<M>

const PAYLOAD_SIZE: usize = 16usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = EsdtTokenPayment<M>

impl<M: ManagedTypeApi> ManagedVecItem for EsdtTokenPaymentMultiValue<M>

const PAYLOAD_SIZE: usize = 16usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = EsdtTokenPaymentMultiValue<M>

impl<M: ManagedTypeApi> ManagedVecItem for ManagedAddress<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, ManagedAddress<M>>

impl<M: ManagedTypeApi> ManagedVecItem for ManagedBuffer<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, ManagedBuffer<M>>

impl<M: ManagedTypeApi> ManagedVecItem for TokenIdentifier<M>

const PAYLOAD_SIZE: usize = 4usize

const SKIPS_RESERIALIZATION: bool = false

type Ref<'a> = ManagedRef<'a, M, TokenIdentifier<M>>