Integers of any length that is a multiple of 32-bits. More...

#include <base_uint.h>

Collaboration diagram for xrpl::BaseUInt< Bits, Tag >:

[legend]

Classes
struct	VoidHelper
	Construct from a raw pointer. More...

Public Types
using	size_type = std::size_t
using	difference_type = std::ptrdiff_t
using	value_type = unsigned char
using	pointer = value_type*
using	reference = value_type&
using	const_pointer = value_type const*
using	const_reference = value_type const&
using	iterator = pointer
using	const_iterator = const_pointer
using	reverse_iterator = std::reverse_iterator<iterator>
using	const_reverse_iterator = std::reverse_iterator<const_iterator>
using	tag_type = Tag
using	hasher = HardenedHash<>
	Value hashing function.

Public Member Functions
pointer	data ()
const_pointer	data () const
iterator	begin ()
iterator	end ()
const_iterator	begin () const
const_iterator	end () const
const_iterator	cbegin () const
const_iterator	cend () const
constexpr	BaseUInt ()
constexpr	BaseUInt (beast::Zero)
	BaseUInt (std::uint64_t b)
constexpr	BaseUInt (std::string_view sv) noexcept(false)
template<class Container> requires ( detail::IsContiguousContainer<Container>::value && std::is_trivially_copyable_v<typename Container::value_type>)
	BaseUInt (Container const &c)
template<class Container> requires ( detail::IsContiguousContainer<Container>::value && std::is_trivially_copyable_v<typename Container::value_type>)
BaseUInt &	operator= (Container const &c)
constexpr int	signum () const
bool	operator! () const
constexpr BaseUInt	operator~ () const
BaseUInt &	operator= (std::uint64_t uHost)
BaseUInt &	operator^= (BaseUInt const &b)
BaseUInt &	operator&= (BaseUInt const &b)
BaseUInt &	operator\|= (BaseUInt const &b)
BaseUInt &	operator++ ()
BaseUInt	operator++ (int)
BaseUInt &	operator-- ()
BaseUInt	operator-- (int)
BaseUInt	next () const
BaseUInt	prev () const
BaseUInt &	operator+= (BaseUInt const &b)
constexpr bool	parseHex (std::string_view sv)
	Parse a hex string into a base_uint.
constexpr bool	parseHex (char const *str)
bool	parseHex (std::string const &str)
BaseUInt< Bits, Tag > &	operator= (beast::Zero)
bool	isZero () const
bool	isNonZero () const
void	zero ()

Static Public Member Functions
template<class Container> requires ( detail::IsContiguousContainer<Container>::value && std::is_trivially_copyable_v<typename Container::value_type>)
static BaseUInt	fromRaw (Container const &c)
static BaseUInt	fromVoid (void const *data)
template<class T>
static std::optional< BaseUInt >	fromVoidChecked (T const &from)
static constexpr std::size_t	size ()

Static Public Attributes
static constexpr std::size_t	kBytes = Bits / 8

Private Types
enum class	ParseResult { Okay , BadLength , BadChar }

Private Member Functions
	BaseUInt (void const *data, VoidHelper)
constexpr std::expected< decltype(data_), ParseResult >	parseFromStringView (std::string_view sv) noexcept
constexpr decltype(data_)	parseFromStringViewThrows (std::string_view sv) noexcept(false)

Private Attributes
std::array< std::uint32_t, kWidth >	data_

Static Private Attributes
static constexpr std::size_t	kWidth = Bits / 32

Friends
template<class Hasher>
void	hash_append (Hasher &h, BaseUInt const &a) noexcept

Detailed Description

template<std::size_t Bits, class Tag = void>
class xrpl::BaseUInt< Bits, Tag >

Integers of any length that is a multiple of 32-bits.

Note: This class stores its values internally in big-endian form and that internal representation is part of the binary protocol of the XRP Ledger and cannot be changed arbitrarily without causing breakage.

Template Parameters

Bits	The number of bits this integer should have; must be at least 64 and a multiple of 32.
Tag	An arbitrary type that functions as a tag and allows the instantiation of "distinct" types that the same number of bits.

Definition at line 81 of file base_uint.h.

Member Typedef Documentation

◆ size_type

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::size_type = std::size_t

Definition at line 103 of file base_uint.h.

◆ difference_type

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::difference_type = std::ptrdiff_t

Definition at line 104 of file base_uint.h.

◆ value_type

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::value_type = unsigned char

Definition at line 105 of file base_uint.h.

◆ pointer

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::pointer = value_type*

Definition at line 106 of file base_uint.h.

◆ reference

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::reference = value_type&

Definition at line 107 of file base_uint.h.

◆ const_pointer

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::const_pointer = value_type const*

Definition at line 108 of file base_uint.h.

◆ const_reference

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::const_reference = value_type const&

Definition at line 109 of file base_uint.h.

◆ iterator

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::iterator = pointer

Definition at line 110 of file base_uint.h.

◆ const_iterator

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::const_iterator = const_pointer

Definition at line 111 of file base_uint.h.

◆ reverse_iterator

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::reverse_iterator = std::reverse_iterator<iterator>

Definition at line 112 of file base_uint.h.

◆ const_reverse_iterator

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::const_reverse_iterator = std::reverse_iterator<const_iterator>

Definition at line 113 of file base_uint.h.

◆ tag_type

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::tag_type = Tag

Definition at line 114 of file base_uint.h.

◆ hasher

template<std::size_t Bits, class Tag = void>

using xrpl::BaseUInt< Bits, Tag >::hasher = HardenedHash<>

Value hashing function.

The seed prevents crafted inputs from causing degenerate parent containers.

Definition at line 163 of file base_uint.h.

Member Enumeration Documentation

◆ ParseResult

template<std::size_t Bits, class Tag = void>

enum class xrpl::BaseUInt::ParseResult

strongprivate

Enumerator
Okay
BadLength
BadChar

Definition at line 187 of file base_uint.h.

Constructor & Destructor Documentation

◆ BaseUInt() [1/6]

template<std::size_t Bits, class Tag = void>

xrpl::BaseUInt< Bits, Tag >::BaseUInt	(	void const *	data,
		VoidHelper	)

explicitprivate

Definition at line 181 of file base_uint.h.

◆ BaseUInt() [2/6]

template<std::size_t Bits, class Tag = void>

xrpl::BaseUInt< Bits, Tag >::BaseUInt ( )

constexpr

Definition at line 265 of file base_uint.h.

◆ BaseUInt() [3/6]

template<std::size_t Bits, class Tag = void>

xrpl::BaseUInt< Bits, Tag >::BaseUInt ( beast::Zero )

constexpr

Definition at line 269 of file base_uint.h.

◆ BaseUInt() [4/6]

template<std::size_t Bits, class Tag = void>

xrpl::BaseUInt< Bits, Tag >::BaseUInt ( std::uint64_t b )

explicit

Definition at line 273 of file base_uint.h.

◆ BaseUInt() [5/6]

template<std::size_t Bits, class Tag = void>

xrpl::BaseUInt< Bits, Tag >::BaseUInt ( std::string_view sv )

explicitconstexpr

Definition at line 281 of file base_uint.h.

◆ BaseUInt() [6/6]

template<std::size_t Bits, class Tag = void>

template<class Container>
requires ( detail::IsContiguousContainer<Container>::value && std::is_trivially_copyable_v<typename Container::value_type>)

xrpl::BaseUInt< Bits, Tag >::BaseUInt ( Container const & c )

explicit

Definition at line 287 of file base_uint.h.

Member Function Documentation

◆ data() [1/2]

template<std::size_t Bits, class Tag = void>

pointer xrpl::BaseUInt< Bits, Tag >::data ( )

Definition at line 117 of file base_uint.h.

◆ data() [2/2]

template<std::size_t Bits, class Tag = void>

const_pointer xrpl::BaseUInt< Bits, Tag >::data ( ) const

nodiscard

Definition at line 122 of file base_uint.h.

◆ begin() [1/2]

template<std::size_t Bits, class Tag = void>

iterator xrpl::BaseUInt< Bits, Tag >::begin ( )

Definition at line 128 of file base_uint.h.

◆ end() [1/2]

template<std::size_t Bits, class Tag = void>

iterator xrpl::BaseUInt< Bits, Tag >::end ( )

Definition at line 133 of file base_uint.h.

◆ begin() [2/2]

template<std::size_t Bits, class Tag = void>

const_iterator xrpl::BaseUInt< Bits, Tag >::begin ( ) const

nodiscard

Definition at line 138 of file base_uint.h.

◆ end() [2/2]

template<std::size_t Bits, class Tag = void>

const_iterator xrpl::BaseUInt< Bits, Tag >::end ( ) const

nodiscard

Definition at line 143 of file base_uint.h.

◆ cbegin()

template<std::size_t Bits, class Tag = void>

const_iterator xrpl::BaseUInt< Bits, Tag >::cbegin ( ) const

nodiscard

Definition at line 148 of file base_uint.h.

◆ cend()

template<std::size_t Bits, class Tag = void>

const_iterator xrpl::BaseUInt< Bits, Tag >::cend ( ) const

nodiscard

Definition at line 153 of file base_uint.h.

◆ parseFromStringView()

template<std::size_t Bits, class Tag = void>

std::expected< decltype(data_), ParseResult > xrpl::BaseUInt< Bits, Tag >::parseFromStringView ( std::string_view sv )

constexprprivatenoexcept

Definition at line 194 of file base_uint.h.

◆ parseFromStringViewThrows()

template<std::size_t Bits, class Tag = void>

decltype(data_) xrpl::BaseUInt< Bits, Tag >::parseFromStringViewThrows ( std::string_view sv )

constexprprivate

Definition at line 251 of file base_uint.h.

◆ fromRaw()

template<std::size_t Bits, class Tag = void>

template<class Container>
requires ( detail::IsContiguousContainer<Container>::value && std::is_trivially_copyable_v<typename Container::value_type>)

BaseUInt xrpl::BaseUInt< Bits, Tag >::fromRaw ( Container const & c )

static

Definition at line 302 of file base_uint.h.

◆ operator=() [1/3]

template<std::size_t Bits, class Tag = void>

template<class Container>
requires ( detail::IsContiguousContainer<Container>::value && std::is_trivially_copyable_v<typename Container::value_type>)

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator= ( Container const & c )

Definition at line 319 of file base_uint.h.

◆ fromVoid()

template<std::size_t Bits, class Tag = void>

BaseUInt xrpl::BaseUInt< Bits, Tag >::fromVoid ( void const * data )

static

Definition at line 339 of file base_uint.h.

◆ fromVoidChecked()

template<std::size_t Bits, class Tag = void>

template<class T>

std::optional< BaseUInt > xrpl::BaseUInt< Bits, Tag >::fromVoidChecked ( T const & from )

static

Definition at line 346 of file base_uint.h.

◆ signum()

template<std::size_t Bits, class Tag = void>

int xrpl::BaseUInt< Bits, Tag >::signum ( ) const

nodiscardconstexpr

Definition at line 354 of file base_uint.h.

◆ operator!()

template<std::size_t Bits, class Tag = void>

bool xrpl::BaseUInt< Bits, Tag >::operator! ( ) const

Definition at line 366 of file base_uint.h.

◆ operator~()

template<std::size_t Bits, class Tag = void>

BaseUInt xrpl::BaseUInt< Bits, Tag >::operator~ ( ) const

constexpr

Definition at line 372 of file base_uint.h.

◆ operator=() [2/3]

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator= ( std::uint64_t uHost )

Definition at line 383 of file base_uint.h.

◆ operator^=()

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator^= ( BaseUInt< Bits, Tag > const & b )

Definition at line 401 of file base_uint.h.

◆ operator&=()

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator&= ( BaseUInt< Bits, Tag > const & b )

Definition at line 410 of file base_uint.h.

◆ operator|=()

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator|= ( BaseUInt< Bits, Tag > const & b )

Definition at line 419 of file base_uint.h.

◆ operator++() [1/2]

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator++ ( )

Definition at line 428 of file base_uint.h.

◆ operator++() [2/2]

template<std::size_t Bits, class Tag = void>

BaseUInt xrpl::BaseUInt< Bits, Tag >::operator++ ( int )

Definition at line 442 of file base_uint.h.

◆ operator--() [1/2]

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator-- ( )

Definition at line 452 of file base_uint.h.

◆ operator--() [2/2]

template<std::size_t Bits, class Tag = void>

BaseUInt xrpl::BaseUInt< Bits, Tag >::operator-- ( int )

Definition at line 467 of file base_uint.h.

◆ next()

template<std::size_t Bits, class Tag = void>

BaseUInt xrpl::BaseUInt< Bits, Tag >::next ( ) const

nodiscard

Definition at line 477 of file base_uint.h.

◆ prev()

template<std::size_t Bits, class Tag = void>

BaseUInt xrpl::BaseUInt< Bits, Tag >::prev ( ) const

nodiscard

Definition at line 484 of file base_uint.h.

◆ operator+=()

template<std::size_t Bits, class Tag = void>

BaseUInt & xrpl::BaseUInt< Bits, Tag >::operator+= ( BaseUInt< Bits, Tag > const & b )

Definition at line 491 of file base_uint.h.

◆ parseHex() [1/3]

template<std::size_t Bits, class Tag = void>

bool xrpl::BaseUInt< Bits, Tag >::parseHex ( std::string_view sv )

nodiscardconstexpr

Parse a hex string into a base_uint.

The input must be precisely 2 * bytes hexadecimal characters long, with one exception: the value '0'.

Parameters

sv	A null-terminated string of hexadecimal characters

Returns: true if the input was parsed properly; false otherwise.

Definition at line 525 of file base_uint.h.

◆ parseHex() [2/3]

template<std::size_t Bits, class Tag = void>

bool xrpl::BaseUInt< Bits, Tag >::parseHex ( char const * str )

nodiscardconstexpr

Definition at line 536 of file base_uint.h.

◆ parseHex() [3/3]

template<std::size_t Bits, class Tag = void>

bool xrpl::BaseUInt< Bits, Tag >::parseHex ( std::string const & str )

nodiscard

Definition at line 542 of file base_uint.h.

◆ size()

template<std::size_t Bits, class Tag = void>

constexpr std::size_t xrpl::BaseUInt< Bits, Tag >::size ( )

staticconstexpr

Definition at line 548 of file base_uint.h.

◆ operator=() [3/3]

template<std::size_t Bits, class Tag = void>

BaseUInt< Bits, Tag > & xrpl::BaseUInt< Bits, Tag >::operator= ( beast::Zero )

Definition at line 554 of file base_uint.h.

◆ isZero()

template<std::size_t Bits, class Tag = void>

bool xrpl::BaseUInt< Bits, Tag >::isZero ( ) const

nodiscard

Definition at line 562 of file base_uint.h.

◆ isNonZero()

template<std::size_t Bits, class Tag = void>

bool xrpl::BaseUInt< Bits, Tag >::isNonZero ( ) const

nodiscard

Definition at line 567 of file base_uint.h.

◆ zero()

template<std::size_t Bits, class Tag = void>

void xrpl::BaseUInt< Bits, Tag >::zero ( )

Definition at line 572 of file base_uint.h.

◆ hash_append

template<std::size_t Bits, class Tag = void>

template<class Hasher>

void hash_append	(	Hasher &	h,
		BaseUInt< Bits, Tag > const &	a )

friend

Definition at line 509 of file base_uint.h.

Member Data Documentation

◆ kWidth

template<std::size_t Bits, class Tag = void>

std::size_t xrpl::BaseUInt< Bits, Tag >::kWidth = Bits / 32

staticconstexprprivate

Definition at line 87 of file base_uint.h.

◆ data_

template<std::size_t Bits, class Tag = void>

std::array<std::uint32_t, kWidth> xrpl::BaseUInt< Bits, Tag >::data_

private

Definition at line 92 of file base_uint.h.

◆ kBytes

template<std::size_t Bits, class Tag = void>

std::size_t xrpl::BaseUInt< Bits, Tag >::kBytes = Bits / 8

staticconstexpr

Definition at line 100 of file base_uint.h.

Classes

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Private Types

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ size_type

◆ difference_type

◆ value_type

◆ pointer

◆ reference

◆ const_pointer

◆ const_reference

◆ iterator

◆ const_iterator

◆ reverse_iterator

◆ const_reverse_iterator

◆ tag_type

◆ hasher

Member Enumeration Documentation

◆ ParseResult

Constructor & Destructor Documentation

◆ BaseUInt() [1/6]

◆ BaseUInt() [2/6]

◆ BaseUInt() [3/6]

◆ BaseUInt() [4/6]

◆ BaseUInt() [5/6]

◆ BaseUInt() [6/6]

Member Function Documentation

◆ data() [1/2]

◆ data() [2/2]

◆ begin() [1/2]

◆ end() [1/2]

◆ begin() [2/2]

◆ end() [2/2]

◆ cbegin()

◆ cend()

◆ parseFromStringView()

◆ parseFromStringViewThrows()

◆ fromRaw()

◆ operator=() [1/3]

◆ fromVoid()

◆ fromVoidChecked()

◆ signum()

◆ operator!()

◆ operator~()

◆ operator=() [2/3]

◆ operator^=()

◆ operator&=()

◆ operator|=()

◆ operator++() [1/2]

◆ operator++() [2/2]

◆ operator--() [1/2]

◆ operator--() [2/2]

◆ next()

◆ prev()

◆ operator+=()

◆ parseHex() [1/3]

◆ parseHex() [2/3]

◆ parseHex() [3/3]

◆ size()

◆ operator=() [3/3]

◆ isZero()

◆ isNonZero()

◆ zero()

Friends And Related Symbol Documentation

◆ hash_append

Member Data Documentation

◆ kWidth

◆ data_

◆ kBytes