Struct elrond_wasm::types::BoxedBytes

pub struct BoxedBytes(_);

Simple wrapper around a boxed byte slice, but with a lot of optimized methods for manipulating it. The focus is on reducing code size rather improving speed.

Implementations

impl BoxedBytes

pub fn empty() -> Self

pub fn zeros(len: usize) -> Self

pub unsafe fn allocate(len: usize) -> Self

Allocates an uninitialized BoxedBytes to heap.

Safety

Should only be called if the contents are initialized immediately afterwards, e.g. via a FFI call.

pub fn as_ptr(&self) -> *const u8

pub fn as_mut_ptr(&mut self) -> *mut u8

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn into_box(self) -> Box<[u8]>

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

pub fn as_slice(&self) -> &[u8]

pub fn as_mut_slice(&mut self) -> &mut [u8]

pub fn from_concat(slices: &[&[u8]]) -> Self

Create new instance by concatenating several byte slices.

pub fn split(self, at: usize) -> (BoxedBytes, BoxedBytes)

Splits BoxedBytes into 2 others at designated position. Returns the original and an empty BoxedBytes if position arugment out of range.

Trait Implementations

impl AsRef<[u8]> for BoxedBytes

fn as_ref(&self) -> &[u8]

Performs the conversion.

impl Clone for BoxedBytes

fn clone(&self) -> BoxedBytes

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BoxedBytes

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

Formats the value using the given formatter.

impl From<&'_ Vec<u8, Global>> for BoxedBytes

fn from(v: &Vec<u8>) -> Self

Performs the conversion.

impl<'a> From<&'a [u8]> for BoxedBytes

fn from(byte_slice: &'a [u8]) -> Self

Performs the conversion.

impl From<Box<[u8], Global>> for BoxedBytes

fn from(b: Box<[u8]>) -> Self

Performs the conversion.

impl<M> From<BoxedBytes> for ManagedSCError<M> where
    M: ManagedTypeApi, 

fn from(message: BoxedBytes) -> Self

Performs the conversion.

impl<M> From<BoxedBytes> for ManagedBuffer<M> where
    M: ManagedTypeApi, 

fn from(bytes: BoxedBytes) -> Self

Performs the conversion.

impl From<Vec<u8, Global>> for BoxedBytes

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

Performs the conversion.

impl NestedDecode for BoxedBytes

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: NestedDecodeInput, ExitCtx: Clone>(
    input: &mut I,
    c: ExitCtx,
    exit: fn(_: ExitCtx, _: DecodeError) -> !
) -> Self

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 NestedEncode for BoxedBytes

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: NestedEncodeOutput, ExitCtx: Clone>(
    &self,
    dest: &mut O,
    c: ExitCtx,
    exit: fn(_: ExitCtx, _: EncodeError) -> !
)

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 PartialEq<BoxedBytes> for BoxedBytes

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

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

fn ne(&self, other: &BoxedBytes) -> bool

This method tests for !=.

impl TopDecode for BoxedBytes

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

Attempt to deserialize the value from input.

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

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 TopEncode for BoxedBytes

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

Attempt to serialize the value to ouput.

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

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 TopEncodeOutput for &mut BoxedBytes

This allows us to use a mutable BoxedBytes as top encode output.

type NestedBuffer = Vec<u8>

Type of NestedEncodeOutput that can be spawned to gather serializations of children.

fn set_slice_u8(self, bytes: &[u8])

fn start_nested_encode(&self) -> Self::NestedBuffer

fn finalize_nested_encode(self, nb: Self::NestedBuffer)

fn set_boxed_bytes(self, bytes: Box<[u8], Global>)

fn set_u64(self, value: u64)

fn set_i64(self, value: i64)

fn set_specialized<T, F>(
    self,
    _value: &T,
    else_serialization: F
) -> Result<(), EncodeError> where
    T: TryStaticCast,
    F: FnOnce(Self) -> Result<(), EncodeError>, 

Allows special handling of special types. Also requires an alternative serialization, in case the special handling is not covered. The alternative serialization, else_serialization is only called when necessary and is normally compiled out via monomorphization.

impl TypeAbi for BoxedBytes

fn type_name() -> String

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 Eq for BoxedBytes

impl StructuralEq for BoxedBytes

impl StructuralPartialEq for BoxedBytes