Struct ManagedOption

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

A very efficient optional managed type.

None is flagged by a special invalid handle.

Implementations

impl<M, T> ManagedOption<M, T>

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

pub fn some(value: T) -> ManagedOption<M, T>

pub fn none() -> ManagedOption<M, T>

impl<M, T> ManagedOption<M, T>

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

pub fn is_none(&self) -> bool

pub fn is_some(&self) -> bool

pub unsafe fn unwrap_no_check(self) -> T

Assumes that value is Some and unwraps without checking.

Safety

Must always be called under an if checking .is_some(), otherwise will lead to undefined behaviour.

pub fn into_option(self) -> Option<T>

pub fn as_option(&self) -> Option<ManagedRef<'_, M, T>>

pub fn unwrap_or_else<F>(self, f: F) -> T

where F: Fn() -> T,

pub fn unwrap_or_sc_panic(self, panic_message: &str) -> T

pub fn map<U, F>(self, f: F) -> ManagedOption<M, U>

where U: ManagedType<M>, F: FnOnce(T) -> U,

pub fn map_or_else<Context, D, F, R>( self, context: Context, default: D, f: F, ) -> R

where D: FnOnce(Context) -> R, F: FnOnce(Context, T) -> R,

pub fn map_ref_or_else<Context, D, F, R>( &self, context: Context, default: D, f: F, ) -> R

where D: FnOnce(Context) -> R, F: FnOnce(Context, &T) -> R,

Trait Implementations

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

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

fn clone(&self) -> ManagedOption<M, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

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

Formats the value using the given formatter.

impl<M, T> From<Option<T>> for ManagedOption<M, T>

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

fn from(opt: Option<T>) -> ManagedOption<M, T>

Converts to this type from the input type.

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

where M: ManagedTypeApi, T: ManagedType<M> + 'static,

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

type PAYLOAD = ManagedVecItemPayloadBuffer<4>

Type managing the underlying binary representation in a ManagedVec..

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

Reference representation of the ManagedVec item.

fn read_from_payload( payload: &<ManagedOption<M, T> as ManagedVecItem>::PAYLOAD, ) -> ManagedOption<M, T>

Parses given bytes as a an owned object.

unsafe fn borrow_from_payload<'a>( payload: &<ManagedOption<M, T> as ManagedVecItem>::PAYLOAD, ) -> <ManagedOption<M, T> as ManagedVecItem>::Ref<'a>

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

fn save_to_payload( self, payload: &mut <ManagedOption<M, T> as ManagedVecItem>::PAYLOAD, )

Converts the object into bytes.

fn payload_size() -> usize

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

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

fn dep_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<ManagedOption<M, T>, <H as DecodeErrorHandler>::HandledErr>

where I: NestedDecodeInput, H: DecodeErrorHandler,

Version of dep_decode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

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

where I: NestedDecodeInput,

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.

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

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

fn dep_encode_or_handle_err<O, H>( &self, dest: &mut O, h: H, ) -> Result<(), <H as EncodeErrorHandler>::HandledErr>

where O: NestedEncodeOutput, H: EncodeErrorHandler,

Version of dep_encode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

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

where O: NestedEncodeOutput,

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

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

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

fn eq(&self, other: &ManagedOption<M, T>) -> bool

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

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<M, T> TopDecode for ManagedOption<M, T>

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

fn top_decode_or_handle_err<I, H>( input: I, h: H, ) -> Result<ManagedOption<M, T>, <H as DecodeErrorHandler>::HandledErr>

where I: TopDecodeInput, H: DecodeErrorHandler,

Version of top_decode that can handle errors as soon as they occur. For instance it can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

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

where I: TopDecodeInput,

Attempt to deserialize the value from input.

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

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

fn top_encode_or_handle_err<O, H>( &self, output: O, h: H, ) -> Result<(), <H as EncodeErrorHandler>::HandledErr>

where O: TopEncodeOutput, H: EncodeErrorHandler,

Version of top_encode that can handle errors as soon as they occur. For instance in can exit immediately and make sure that if it returns, it is a success. By not deferring error handling, this can lead to somewhat smaller bytecode.

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

where O: TopEncodeOutput,

Attempt to serialize the value to ouput.

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

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

fn type_name() -> String

It is semantically equivalent to any list of T.

type Unmanaged = Option<<T as TypeAbi>::Unmanaged>

fn type_name_rust() -> String

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

where TDC: TypeDescriptionContainer,

A type can provide more than its own name. 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.

fn type_names() -> TypeNames

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

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

impl<M, T, U> TypeAbiFrom<ManagedOption<M, U>> for ManagedOption<M, T>

where M: ManagedTypeApi, U: ManagedType<M>, T: ManagedType<M> + TypeAbiFrom<U>,

impl<M, T, U> TypeAbiFrom<Option<U>> for ManagedOption<M, T>

where M: ManagedTypeApi, T: ManagedType<M> + TypeAbiFrom<U>,