Struct ExtraCurrencyCollection

pub struct ExtraCurrencyCollection(/* private fields */);

Dictionary with amounts for multiple currencies.

Implementations

impl ExtraCurrencyCollection

pub const fn new() -> Self

Creates an empty extra currency collection.

pub const fn from_raw(dict: Option<Cell>) -> Self

Creates a currency collection from a raw cell.

pub fn try_from_iter<I>(iter: I) -> Result<Self, Error>

where I: IntoIterator<Item = (u32, VarUint248)>,

Creates an ExtraCurrencyCollection from an iterator of id-amount pairs.

pub const fn is_empty(&self) -> bool

Returns true if the dictionary contains no elements.

pub const fn as_dict(&self) -> &Dict<u32, VarUint248>

Returns a reference to the underlying dictionary.

pub fn into_dict(self) -> Dict<u32, VarUint248>

Returns the underlying dictionary.

pub fn as_dict_mut(&mut self) -> &mut Dict<u32, VarUint248>

Returns a mutable reference to the underlying dictionary.

pub fn normalized(&self) -> Result<Self, Error>

Removes all currencies with zero balance.

pub fn normalize(&mut self) -> Result<(), Error>

Removes all currencies with zero balance.

pub fn checked_add(&self, other: &Self) -> Result<Self, Error>

Checked extra currency collection addition. Computes self + rhs for each currency, returning Err if overflow occurred or dictionaries had invalid structure.

pub fn checked_sub(&self, other: &Self) -> Result<Self, Error>

Checked extra currency subtraction. Computes self - rhs for each currency, returning Err if overflow occurred or dictionaries had invalid structure.

pub fn checked_clamp(&self, other: &Self) -> Result<Self, Error>

Returns the intersection between two extra currency collections.

Trait Implementations

impl Clone for ExtraCurrencyCollection

fn clone(&self) -> ExtraCurrencyCollection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExtraCurrencyCollection

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

Formats the value using the given formatter.

impl Default for ExtraCurrencyCollection

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ExtraCurrencyCollection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl ExactSize for ExtraCurrencyCollection

fn exact_size(&self) -> Size

Exact size of the value when it is stored in a slice.

impl From<Dict<u32, VarUint248>> for ExtraCurrencyCollection

fn from(value: Dict<u32, VarUint248>) -> Self

Converts to this type from the input type.

impl From<ExtraCurrencyCollection> for Dict<u32, VarUint248>

fn from(value: ExtraCurrencyCollection) -> Self

Converts to this type from the input type.

impl<'tlb> Load<'tlb> for ExtraCurrencyCollection

fn load_from(__slice: &mut CellSlice<'tlb>) -> Result<Self, Error>

Tries to load itself from a cell slice.

impl PartialEq for ExtraCurrencyCollection

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

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

const 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 Serialize for ExtraCurrencyCollection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Store for ExtraCurrencyCollection

fn store_into( &self, __builder: &mut CellBuilder, __context: &dyn CellContext, ) -> Result<(), Error>

Tries to store itself into the cell builder.

impl TryFrom<&BTreeMap<u32, VarUint248>> for ExtraCurrencyCollection

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &BTreeMap<u32, VarUint248>) -> Result<Self, Self::Error>

Performs the conversion.

impl<S> TryFrom<&HashMap<u32, VarUint248, S>> for ExtraCurrencyCollection

where S: BuildHasher,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: &HashMap<u32, VarUint248, S>) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<BTreeMap<u32, VarUint248>> for ExtraCurrencyCollection

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: BTreeMap<u32, VarUint248>) -> Result<Self, Self::Error>

Performs the conversion.

impl<S> TryFrom<HashMap<u32, VarUint248, S>> for ExtraCurrencyCollection

where S: BuildHasher,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: HashMap<u32, VarUint248, S>) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for ExtraCurrencyCollection

impl StructuralPartialEq for ExtraCurrencyCollection