A serializable number. More...

#include <STNumber.h>

Inheritance diagram for xrpl::STNumber:

[legend]

Collaboration diagram for xrpl::STNumber:

[legend]

Public Types
using	value_type = Number

Public Member Functions
	STNumber ()=default
	STNumber (SField const &field, Number const &value=Number())
	STNumber (SerialIter &sit, SField const &field)
SerializedTypeID	getSType () const override
std::string	getText () const override
void	add (Serializer &s) const override
Number const &	value () const
void	setValue (Number const &v)
STNumber &	operator= (Number const &rhs)
bool	isEquivalent (STBase const &t) const override
bool	isDefault () const override
void	associateAsset (Asset const &a) override
	operator Number () const
	STBase ()
	STBase (STBase const &)=default
	STBase (SField const &n)
bool	operator== (STBase const &t) const
bool	operator!= (STBase const &t) const
template<class D>
D &	downcast ()
template<class D>
D const &	downcast () const
template<class D>
D const &	downcast () const
virtual std::string	getFullText () const
virtual json::Value	getJson (JsonOptions=JsonOptions::Values::None) const
void	setFName (SField const &n)
	A STBase is a field.
SField const &	getFName () const
void	addFieldID (Serializer &s) const

Public Attributes
friend	Object

Static Protected Member Functions
template<class T>
static STBase *	emplace (std::size_t n, void *buf, T &&val)

Protected Attributes
std::optional< Asset >	asset_

Private Member Functions
STBase *	copy (std::size_t n, void *buf) const override
STBase *	move (std::size_t n, void *buf) override

Static Private Member Functions
static auto &	getCounter () noexcept

Private Attributes
Number	value_
SField const *	fName_

Detailed Description

A serializable number.

This type is-a Number, and can be used everywhere that is accepted. This type simply integrates Number with the serialization framework, letting it be used for fields in ledger entries and transactions. It is effectively an STAmount sans Asset: it can represent a value of any token type (XRP, IOU, or MPT) without paying the storage cost of duplicating asset information that may be deduced from the context.

STNumber derives from STTakesAsset, so that it can be associated with the related Asset during transaction processing. Which asset is relevant depends on the object and transaction. As of this writing, only Vault, LoanBroker, and Loan objects use STNumber fields. All of those fields represent amounts of the Vault's Asset, so they should be associated with the Vault's Asset.

e.g. associateAsset(*loanSle, asset); associateAsset(*brokerSle, asset); associateAsset(*vaultSle, asset);

Definition at line 34 of file STNumber.h.

Member Typedef Documentation

◆ value_type

using xrpl::STNumber::value_type = Number

Definition at line 40 of file STNumber.h.

Constructor & Destructor Documentation

◆ STNumber() [1/3]

xrpl::STNumber::STNumber ( )

default

◆ STNumber() [2/3]

xrpl::STNumber::STNumber	(	SField const &	field,
		Number const &	value = Number() )

explicit

Definition at line 30 of file STNumber.cpp.

◆ STNumber() [3/3]

xrpl::STNumber::STNumber	(	SerialIter &	sit,
		SField const &	field )

Definition at line 34 of file STNumber.cpp.

Member Function Documentation

◆ getSType()

SerializedTypeID xrpl::STNumber::getSType ( ) const

nodiscardoverridevirtual

Reimplemented from xrpl::STBase.

Definition at line 44 of file STNumber.cpp.

◆ getText()

std::string xrpl::STNumber::getText ( ) const

nodiscardoverridevirtual

Reimplemented from xrpl::STBase.

Definition at line 50 of file STNumber.cpp.

◆ add()

void xrpl::STNumber::add ( Serializer & s ) const

overridevirtual

Reimplemented from xrpl::STBase.

Definition at line 69 of file STNumber.cpp.

◆ value()

Number const & xrpl::STNumber::value ( ) const

nodiscard

Definition at line 117 of file STNumber.cpp.

◆ setValue()

void xrpl::STNumber::setValue ( Number const & v )

Definition at line 123 of file STNumber.cpp.

◆ operator=()

STNumber & xrpl::STNumber::operator= ( Number const & rhs )

Definition at line 59 of file STNumber.h.

◆ isEquivalent()

bool xrpl::STNumber::isEquivalent ( STBase const & t ) const

nodiscardoverridevirtual

Reimplemented from xrpl::STBase.

Definition at line 141 of file STNumber.cpp.

◆ isDefault()

bool xrpl::STNumber::isDefault ( ) const

nodiscardoverridevirtual

Reimplemented from xrpl::STBase.

Definition at line 150 of file STNumber.cpp.

◆ associateAsset()

void xrpl::STNumber::associateAsset ( Asset const & a )

overridevirtual

Reimplemented from xrpl::STTakesAsset.

Definition at line 56 of file STNumber.cpp.

◆ operator Number()

xrpl::STNumber::operator Number ( ) const

Definition at line 73 of file STNumber.h.

◆ copy()

STBase * xrpl::STNumber::copy	(	std::size_t	n,
		void *	buf ) const

overrideprivatevirtual

Reimplemented from xrpl::STBase.

Definition at line 129 of file STNumber.cpp.

◆ move()

STBase * xrpl::STNumber::move	(	std::size_t	n,
		void *	buf )

overrideprivatevirtual

Reimplemented from xrpl::STBase.

Definition at line 135 of file STNumber.cpp.

◆ STBase() [1/3]

xrpl::STBase::STBase ( )

inherited

Definition at line 122 of file STBase.cpp.

◆ STBase() [2/3]

xrpl::STBase::STBase ( STBase const & )

defaultinherited

◆ STBase() [3/3]

xrpl::STBase::STBase ( SField const & n )

explicitinherited

Definition at line 127 of file STBase.cpp.

◆ operator==()

bool xrpl::STBase::operator== ( STBase const & t ) const

inherited

Definition at line 36 of file STBase.cpp.

◆ operator!=()

bool xrpl::STBase::operator!= ( STBase const & t ) const

inherited

Definition at line 42 of file STBase.cpp.

◆ downcast() [1/3]

template<class D>

D & xrpl::STBase::downcast ( )

inherited

Definition at line 195 of file STBase.h.

◆ downcast() [2/3]

template<class D>

D const & xrpl::STBase::downcast ( ) const

inherited

◆ downcast() [3/3]

template<class D>

D const & xrpl::STBase::downcast ( ) const

nodiscardinherited

Definition at line 205 of file STBase.h.

◆ getFullText()

std::string xrpl::STBase::getFullText ( ) const

nodiscardvirtualinherited

Reimplemented in xrpl::STAmount, xrpl::STArray, xrpl::STLedgerEntry, xrpl::STObject, and xrpl::STTx.

Definition at line 66 of file STBase.cpp.

◆ getJson()

json::Value xrpl::STBase::getJson ( JsonOptions = JsonOptions::Values::None ) const

nodiscardvirtualinherited

Reimplemented in xrpl::STAmount, xrpl::STArray, xrpl::STCurrency, xrpl::STInteger< Integer >, xrpl::STInteger< std::int32_t >, xrpl::STInteger< std::uint16_t >, xrpl::STInteger< std::uint32_t >, xrpl::STInteger< std::uint64_t >, xrpl::STInteger< unsigned char >, xrpl::STIssue, xrpl::STLedgerEntry, xrpl::STObject, xrpl::STPathSet, xrpl::STTx, xrpl::STVector256, and xrpl::STXChainBridge.

Definition at line 91 of file STBase.cpp.

◆ setFName()

void xrpl::STBase::setFName ( SField const & n )

inherited

A STBase is a field.

This sets the name.

Definition at line 119 of file STBase.cpp.

◆ getFName()

SField const & xrpl::STBase::getFName ( ) const

nodiscardinherited

Definition at line 126 of file STBase.cpp.

◆ addFieldID()

void xrpl::STBase::addFieldID ( Serializer & s ) const

inherited

Definition at line 132 of file STBase.cpp.

◆ emplace()

template<class T>

STBase * xrpl::STBase::emplace	(	std::size_t	n,
		void *	buf,
		T &&	val )

staticprotectedinherited

Definition at line 215 of file STBase.h.

◆ getCounter()

auto & xrpl::CountedObject< STNumber >::getCounter ( )

staticprivatenoexceptinherited

Definition at line 109 of file CountedObject.h.

Member Data Documentation

◆ value_

Number xrpl::STNumber::value_

private

Definition at line 37 of file STNumber.h.

◆ asset_

std::optional<Asset> xrpl::STTakesAsset::asset_

protectedinherited

Definition at line 24 of file STTakesAsset.h.

◆ fName_

SField const* xrpl::STBase::fName_

privateinherited

Definition at line 118 of file STBase.h.

◆ Object

friend xrpl::CountedObject< STNumber >::STNumber

inherited

Definition at line 134 of file CountedObject.h.

Public Types

Public Member Functions

Public Attributes

Static Protected Member Functions

Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ value_type

Constructor & Destructor Documentation

◆ STNumber() [1/3]

◆ STNumber() [2/3]

◆ STNumber() [3/3]

Member Function Documentation

◆ getSType()

◆ getText()

◆ add()

◆ value()

◆ setValue()

◆ operator=()

◆ isEquivalent()

◆ isDefault()

◆ associateAsset()

◆ operator Number()

◆ copy()

◆ move()

◆ STBase() [1/3]

◆ STBase() [2/3]

◆ STBase() [3/3]

◆ operator==()

◆ operator!=()

◆ downcast() [1/3]

◆ downcast() [2/3]

◆ downcast() [3/3]

◆ getFullText()

◆ getJson()

◆ setFName()

◆ getFName()

◆ addFieldID()

◆ emplace()

◆ getCounter()

Member Data Documentation

◆ value_

◆ asset_

◆ fName_

◆ Object