Struct ManagedRef

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

A very efficient reference to a managed type, with copy semantics.

It copies the handle and knows how to deref back.

Implementations

impl<'a, M, T> ManagedRef<'a, M, T>

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

pub fn new(value: &'a T) -> ManagedRef<'a, M, T>

impl<M, T> ManagedRef<'_, M, T>

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

pub fn clone_value(&self) -> T

Syntactic sugar for dereferencing and cloning the object.

impl<M, T> ManagedRef<'_, M, T>

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

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

Clones the reference itself, not the object contained therein.

Trait Implementations

impl<Env> AnnotatedValue<Env, BigUint<<Env as TxEnv>::Api>> for ManagedRef<'_, <Env as TxEnv>::Api, BigUint<<Env as TxEnv>::Api>>

where Env: TxEnv,

fn annotation(&self, _env: &Env) -> ManagedBuffer<<Env as TxEnv>::Api>

fn to_value(&self, _env: &Env) -> BigUint<<Env as TxEnv>::Api>

Produces the value from a reference of the annotated type. Might involve a .clone() in some cases.

fn into_value(self, _env: &Env) -> BigUint<<Env as TxEnv>::Api>

Consumes annotated value to produce actual value.

fn with_value_ref<F, R>(&self, _env: &Env, f: F) -> R

where F: FnOnce(&BigUint<<Env as TxEnv>::Api>) -> R,

Can be used when working with references only.

impl<M, T> Borrow<T> for ManagedRef<'_, M, T>

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

fn borrow(&self) -> &T

Immutably borrows from an owned value.

impl<M, T> Debug for ManagedRef<'_, 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> Deref for ManagedRef<'_, M, T>

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

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &<ManagedRef<'_, M, T> as Deref>::Target

Dereferences the value.

impl<'a, M, T> From<&'a T> for ManagedRef<'a, M, T>

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

fn from(value_ref: &'a T) -> ManagedRef<'a, M, T>

Converts to this type from the input type.

impl<M, T> NestedEncode for ManagedRef<'_, 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 ManagedRef<'_, M, T>

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

fn eq(&self, other: &ManagedRef<'_, 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> TopEncode for ManagedRef<'_, M, T>

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

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<Env> TxPayment<Env> for ManagedRef<'_, <Env as TxEnv>::Api, ManagedVec<<Env as TxEnv>::Api, EgldOrEsdtTokenPayment<<Env as TxEnv>::Api>>>

where Env: TxEnv,

fn is_no_payment(&self, _env: &Env) -> bool

Returns true if payment indicates transfer of either non-zero EGLD or ESDT amounts.

fn perform_transfer_execute( self, env: &Env, to: &ManagedAddress<<Env as TxEnv>::Api>, gas_limit: u64, fc: FunctionCall<<Env as TxEnv>::Api>, )

Transfer-execute calls have different APIs for different payments types. This method selects between them.

fn with_normalized<From, To, F, R>( self, env: &Env, from: &From, to: To, fc: FunctionCall<<Env as TxEnv>::Api>, f: F, ) -> R

where From: TxFrom<Env>, To: TxToSpecified<Env>, F: FnOnce(&ManagedAddress<<Env as TxEnv>::Api>, &BigUint<<Env as TxEnv>::Api>, FunctionCall<<Env as TxEnv>::Api>) -> R,

Converts an ESDT call to a built-in function call, if necessary.

fn into_full_payment_data( self, env: &Env, ) -> FullPaymentData<<Env as TxEnv>::Api>

Payment data to be used by the testing framework. Will be refactored.

impl<Env> TxPayment<Env> for ManagedRef<'_, <Env as TxEnv>::Api, ManagedVec<<Env as TxEnv>::Api, EsdtTokenPayment<<Env as TxEnv>::Api>>>

where Env: TxEnv,

fn is_no_payment(&self, _env: &Env) -> bool

Returns true if payment indicates transfer of either non-zero EGLD or ESDT amounts.

fn perform_transfer_execute( self, env: &Env, to: &ManagedAddress<<Env as TxEnv>::Api>, gas_limit: u64, fc: FunctionCall<<Env as TxEnv>::Api>, )

Transfer-execute calls have different APIs for different payments types. This method selects between them.

fn with_normalized<From, To, F, R>( self, env: &Env, from: &From, to: To, fc: FunctionCall<<Env as TxEnv>::Api>, f: F, ) -> R

where From: TxFrom<Env>, To: TxToSpecified<Env>, F: FnOnce(&ManagedAddress<<Env as TxEnv>::Api>, &BigUint<<Env as TxEnv>::Api>, FunctionCall<<Env as TxEnv>::Api>) -> R,

Converts an ESDT call to a built-in function call, if necessary.

fn into_full_payment_data( self, env: &Env, ) -> FullPaymentData<<Env as TxEnv>::Api>

Payment data to be used by the testing framework. Will be refactored.

impl<M, T> Eq for ManagedRef<'_, M, T>

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

impl<Env> TxEgldValue<Env> for ManagedRef<'_, <Env as TxEnv>::Api, BigUint<<Env as TxEnv>::Api>>

where Env: TxEnv,

impl<Env> TxPaymentMultiEsdt<Env> for ManagedRef<'_, <Env as TxEnv>::Api, ManagedVec<<Env as TxEnv>::Api, EsdtTokenPayment<<Env as TxEnv>::Api>>>

where Env: TxEnv,