Struct EgldOrEsdtTokenIdentifier

pub struct EgldOrEsdtTokenIdentifier<M: ManagedTypeApi> { /* private fields */ }

Specialized type for handling either EGLD or ESDT token identifiers.

Equivalent to a structure of the form

enum EgldOrEsdtTokenIdentifier<M: ManagedTypeApi> {
    Egld,
    Esdt(TokenIdentifier<M>),
}

It is, however more optimized than that. Its implementation is based on ManagedOption.

EGLD is indicated by a special, invalid token identifier handle. This way we can fit it inside a single i32 in memory.

Implementations

impl<M: ManagedTypeApi> EgldOrEsdtTokenIdentifier<M>

pub const EGLD_REPRESENTATION: &'static [u8; 4] = b"EGLD"

This special representation is interpreted as the EGLD token.

pub fn egld() -> Self

New instance of the special EGLD token representation.

pub fn esdt<TI>(token_identifier: TI) -> Self

where TokenIdentifier<M>: From<TI>,

ESDT instance, containing an ESDT token identifier.

pub fn parse(data: ManagedBuffer<M>) -> Self

pub fn is_egld(&self) -> bool

pub fn is_esdt(&self) -> bool

pub fn into_name(self) -> ManagedBuffer<M>

Returns “EGLD” or the token identifier.

pub fn is_valid(&self) -> bool

Checks the ESDT token identifier for validity. EGLD is considered valid, no checks needed.

Will fail if it encodes an invalid ESDT token identifier.

pub fn into_managed_buffer(self) -> ManagedBuffer<M>

pub fn as_managed_buffer(&self) -> &ManagedBuffer<M>

pub fn to_boxed_bytes(&self) -> BoxedBytes

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

where D: FnOnce(Context) -> R, F: FnOnce(Context, TokenIdentifier<M>) -> R,

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

where D: FnOnce(Context) -> R, F: FnOnce(Context, &TokenIdentifier<M>) -> R,

pub fn unwrap_esdt(self) -> TokenIdentifier<M>

pub fn as_esdt_option(&self) -> Option<ManagedRef<'_, M, TokenIdentifier<M>>>

Representation of the object as an Option.

Because it does not consume self only a reference to the ESDT token identifier can be returned.

pub fn into_esdt_option(self) -> Option<TokenIdentifier<M>>

Converts self into an Option. Consumes self in the process.

Trait Implementations

impl<M: Clone + ManagedTypeApi> Clone for EgldOrEsdtTokenIdentifier<M>

fn clone(&self) -> EgldOrEsdtTokenIdentifier<M>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<M> Debug for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,

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

Formats the value using the given formatter.

impl<M: ManagedTypeApi> From<&[u8]> for EgldOrEsdtTokenIdentifier<M>

fn from(bytes: &[u8]) -> Self

Converts to this type from the input type.

impl<M: ManagedTypeApi> From<ManagedBuffer<M>> for EgldOrEsdtTokenIdentifier<M>

fn from(buffer: ManagedBuffer<M>) -> Self

Converts to this type from the input type.

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

type OwnHandle = <M as HandleTypeInfo>::ManagedBufferHandle

fn get_handle(&self) -> M::ManagedBufferHandle

unsafe fn forget_into_handle(self) -> Self::OwnHandle

Forgets current object (does not run destructor), but extracts the handle.

fn transmute_from_handle_ref(handle_ref: &M::ManagedBufferHandle) -> &Self

Implement carefully, since the underlying transmutation is an unsafe operation. For types that wrap a handle to some VM-managed data, make sure the type only contains the handle (plus ZSTs if necessary). For types that just wrap another managed type it is easier, call for the wrapped object.

fn transmute_from_handle_ref_mut( handle_ref: &mut M::ManagedBufferHandle, ) -> &mut Self

fn get_raw_handle(&self) -> RawHandle

fn as_ref(&self) -> ManagedRef<'_, M, Self>

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

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> = ManagedRef<'a, M, EgldOrEsdtTokenIdentifier<M>>

Reference representation of the ManagedVec item.

fn read_from_payload(payload: &Self::PAYLOAD) -> Self

Parses given bytes as a an owned object.

unsafe fn borrow_from_payload<'a>(payload: &Self::PAYLOAD) -> Self::Ref<'a>

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

fn save_to_payload(self, payload: &mut Self::PAYLOAD)

Converts the object into bytes.

fn payload_size() -> usize

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

fn dep_decode_or_handle_err<I, H>( input: &mut I, h: H, ) -> Result<Self, H::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: ManagedTypeApi> NestedEncode for EgldOrEsdtTokenIdentifier<M>

fn dep_encode_or_handle_err<O, H>( &self, dest: &mut O, h: H, ) -> Result<(), H::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: ManagedTypeApi> PartialEq<EgldOrEsdtTokenIdentifier<M>> for TokenIdentifier<M>

fn eq(&self, other: &EgldOrEsdtTokenIdentifier<M>) -> 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: ManagedTypeApi> PartialEq<TokenIdentifier<M>> for EgldOrEsdtTokenIdentifier<M>

fn eq(&self, other: &TokenIdentifier<M>) -> 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: ManagedTypeApi> PartialEq for EgldOrEsdtTokenIdentifier<M>

fn eq(&self, other: &Self) -> 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: ManagedTypeApi> SCDisplay for EgldOrEsdtTokenIdentifier<M>

fn fmt<F: FormatByteReceiver>(&self, f: &mut F)

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

fn fmt<F: FormatByteReceiver>(&self, f: &mut F)

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

fn top_decode_or_handle_err<I, H>(input: I, h: H) -> Result<Self, H::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: ManagedTypeApi> TopEncode for EgldOrEsdtTokenIdentifier<M>

fn top_encode_or_handle_err<O, H>( &self, output: O, h: H, ) -> Result<(), H::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: ManagedTypeApi> TypeAbi for EgldOrEsdtTokenIdentifier<M>

type Unmanaged = EgldOrEsdtTokenIdentifier<M>

fn type_name() -> TypeName

fn type_name_rust() -> TypeName

fn type_names() -> TypeNames

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

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.

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

impl<M> TypeAbiFrom<&[u8]> for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,

impl<M: ManagedTypeApi> TypeAbiFrom<&EgldOrEsdtTokenIdentifier<M>> for EgldOrEsdtTokenIdentifier<M>

impl<M> TypeAbiFrom<&TestTokenIdentifier<'_>> for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<&TokenIdentifier<M>> for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<&str> for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,

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

impl<M> TypeAbiFrom<TestTokenIdentifier<'_>> for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,

impl<M> TypeAbiFrom<TokenIdentifier<M>> for EgldOrEsdtTokenIdentifier<M>

where M: ManagedTypeApi,