Struct Trx 

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

An amount of TRX, stored internally as i64 sun.

User-facing constructors enforce non-negative amounts. Negative values remain representable only so malformed protobuf or serialized data can be inspected and round-tripped without panicking; arithmetic operations reject them.

Parses from and displays as a decimal TRX string with six fractional digits; see parse_trx and format_trx.

Implementations

impl Trx

pub const ZERO: Trx

Zero TRX.

pub const fn from_sun_unchecked(sun: i64) -> Self

Construct from a sun value without rejecting negatives.

For protobuf round-tripping and malformed on-chain data only; prefer Trx::from_sun for user input, balances, transfers, and contract calls.

pub const fn from_sun(sun: i64) -> Result<Self, AmountError>

Construct from a raw sun value, rejecting negatives.

pub const fn as_sun(self) -> i64

The raw sun value.

pub fn checked_add(self, rhs: Trx) -> Option<Trx>

Checked addition. Returns None on i64 overflow or if either operand is negative.

pub fn checked_sub(self, rhs: Trx) -> Option<Trx>

Checked subtraction. Returns None on i64 overflow, if either operand is negative, or if the result would be negative.

Trait Implementations

impl Add for Trx

fn add(self, rhs: Trx) -> Trx

Panics

Panics on i64 overflow or a negative result. Use Trx::checked_add for a non-panicking alternative.

type Output = Trx

The resulting type after applying the + operator.

impl Clone for Trx

fn clone(&self) -> Trx

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Trx

impl Debug for Trx

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

Formats the value using the given formatter.

impl Default for Trx

fn default() -> Trx

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Trx

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Trx

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

Formats the value using the given formatter.

impl Eq for Trx

impl FromStr for Trx

type Err = AmountError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Trx

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Trx

fn cmp(&self, other: &Trx) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Trx

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Trx

fn partial_cmp(&self, other: &Trx) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Trx

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Trx

impl Sub for Trx

fn sub(self, rhs: Trx) -> Trx

Panics

Panics on i64 overflow or a negative result. Use Trx::checked_sub for a non-panicking alternative.

type Output = Trx

The resulting type after applying the - operator.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 8 bytes