ripple::IOUAmount Class Reference

Floating point representation of amounts with high dynamic range. More...

Inheritance diagram for ripple::IOUAmount:

Collaboration diagram for ripple::IOUAmount:

Public Member Functions
	IOUAmount ()=default
	IOUAmount (Number const &other)
	IOUAmount (beast::Zero)
	IOUAmount (std::int64_t mantissa, int exponent)
IOUAmount &	operator= (beast::Zero)
	operator Number () const
IOUAmount &	operator+= (IOUAmount const &other)
IOUAmount &	operator-= (IOUAmount const &other)
IOUAmount	operator- () const
bool	operator== (IOUAmount const &other) const
bool	operator< (IOUAmount const &other) const
	operator bool () const noexcept
	Returns true if the amount is not zero. More...
int	signum () const noexcept
	Return the sign of the amount. More...
int	exponent () const noexcept
std::int64_t	mantissa () const noexcept

Static Public Member Functions
static IOUAmount	minPositiveAmount ()

Private Member Functions
void	normalize ()
	Adjusts the mantissa and exponent to the proper range. More...

Private Attributes
std::int64_t	mantissa_
int	exponent_

Detailed Description

Floating point representation of amounts with high dynamic range.

Amounts are stored as a normalized signed mantissa and an exponent. The range of the normalized exponent is [-96,80] and the range of the absolute value of the normalized mantissa is [1000000000000000, 9999999999999999].

Arithmetic operations can throw std::overflow_error during normalization if the amount exceeds the largest representable amount, but underflows will silently trunctate to zero.

Definition at line 43 of file IOUAmount.h.

Constructor & Destructor Documentation

IOUAmount() [1/4]

ripple::IOUAmount::IOUAmount ( )

default

IOUAmount() [2/4]

ripple::IOUAmount::IOUAmount ( Number const &  other )

explicit

Definition at line 120 of file IOUAmount.cpp.

IOUAmount() [3/4]

ripple::IOUAmount::IOUAmount

(

beast::Zero

)

Definition at line 101 of file IOUAmount.h.

IOUAmount() [4/4]

ripple::IOUAmount::IOUAmount	(	std::int64_t	mantissa,
		int	exponent
	)

Definition at line 106 of file IOUAmount.h.

Member Function Documentation

normalize()

void ripple::IOUAmount::normalize ( )

private

Adjusts the mantissa and exponent to the proper range.

This can throw if the amount cannot be normalized, or is larger than the largest value that can be represented as an IOU amount. Amounts that are too small to be represented normalize to 0.

Definition at line 67 of file IOUAmount.cpp.

operator=()

IOUAmount & ripple::IOUAmount::operator=

(

beast::Zero

)

Definition at line 112 of file IOUAmount.h.

operator Number()

ripple::IOUAmount::operator Number

(

)

const

Definition at line 121 of file IOUAmount.h.

operator+=()

IOUAmount & ripple::IOUAmount::operator+=

(

IOUAmount const &

other

)

Definition at line 130 of file IOUAmount.cpp.

operator-=()

IOUAmount & ripple::IOUAmount::operator-=

(

IOUAmount const &

other

)

Definition at line 127 of file IOUAmount.h.

operator-()

IOUAmount ripple::IOUAmount::operator-

(

)

const

Definition at line 134 of file IOUAmount.h.

operator==()

bool ripple::IOUAmount::operator==

(

IOUAmount const &

other

)

const

Definition at line 140 of file IOUAmount.h.

operator<()

bool ripple::IOUAmount::operator<

(

IOUAmount const &

other

)

const

Definition at line 146 of file IOUAmount.h.

operator bool()

ripple::IOUAmount::operator bool ( ) const

explicitnoexcept

Returns true if the amount is not zero.

Definition at line 151 of file IOUAmount.h.

signum()

int ripple::IOUAmount::signum ( ) const

noexcept

Return the sign of the amount.

Definition at line 157 of file IOUAmount.h.

exponent()

int ripple::IOUAmount::exponent ( ) const

noexcept

Definition at line 163 of file IOUAmount.h.

mantissa()

std::int64_t ripple::IOUAmount::mantissa ( ) const

noexcept

Definition at line 169 of file IOUAmount.h.

minPositiveAmount()

IOUAmount ripple::IOUAmount::minPositiveAmount ( )

static

Definition at line 61 of file IOUAmount.cpp.

Member Data Documentation

mantissa_

std::int64_t ripple::IOUAmount::mantissa_

private

Definition at line 47 of file IOUAmount.h.

exponent_

int ripple::IOUAmount::exponent_

private

Definition at line 48 of file IOUAmount.h.