#include <tsFixedPoint.h>

Inheritance diagram for ts::FixedPoint< INT_T, PREC >:

Collaboration diagram for ts::FixedPoint< INT_T, PREC >:

[legend]

Public Types
using	int_t = INT_T

Public Member Functions
	FixedPoint ()=default
template<typename INT2> requires std::integral<INT2>
	FixedPoint (INT2 i)
	FixedPoint (int_t i, bool raw)
FixedPoint	abs () const
virtual ts::UString	description () const override
bool	divOverflow (const FixedPoint &x) const
virtual bool	fromString (const UString &str, UChar separator=COMMA, UChar decimal_dot=FULL_STOP) override
virtual bool	inRange (int64_t min, int64_t max) const override
FixedPoint	max (const FixedPoint &x) const
FixedPoint	min (const FixedPoint &x) const
bool	mulOverflow (const FixedPoint &x) const
template<typename INT2> requires std::integral<INT2>
bool	mulOverflow (INT2 x) const
int_t	raw () const
virtual double	toDouble () const override
int_t	toInt () const
virtual int64_t	toInt64 () const override
virtual UString	toString (size_t min_width=0, bool right_justified=true, UChar separator=COMMA, bool force_sign=false, size_t decimals=NPOS, bool force_decimals=false, UChar decimal_dot=FULL_STOP, UChar pad=SPACE) const override

Static Public Attributes
static constexpr int_t	FACTOR = ts::static_power10<int_t, PRECISION>::value
static const AbstractNumber *const	INVALID
static const FixedPoint	MAX
static const FixedPoint	MIN
static constexpr size_t	PRECISION = PREC

Static Protected Member Functions
static void	Deformat (UString &str, UChar separator, UChar decimal_dot)
static void	Format (UString &str, size_t min_width, bool right_justified, UChar separator, bool add_plus_sign, size_t decimals, bool force_decimals, UChar decimal_dot, UChar pad)

Detailed Description

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>
class ts::FixedPoint< INT_T, PREC >

Template representation of fixed-precision numbers.

A fixed-precision number is internally represented by an integer but with a different representation of a "unit". This concept is inspired by "fixed" types in Ada.

All arithmetic and comparison operators are defined between fixed-point type values and between a fixed-point value and an integer value, both directions.

Template Parameters

INT_T	The underlying signed integer type.
PREC	The decimal precision in digits.

Member Typedef Documentation

◆ int_t

template<typename INT_T, const size_t PREC>

using ts::FixedPoint< INT_T, PREC >::int_t = INT_T

The underlying signed integer type.

Constructor & Destructor Documentation

◆ FixedPoint() [1/3]

template<typename INT_T, const size_t PREC>

ts::FixedPoint< INT_T, PREC >::FixedPoint ( )

default

Default constructor, implicitly initialized to zero.

◆ FixedPoint() [2/3]

template<typename INT_T, const size_t PREC>

template<typename INT2>
requires std::integral<INT2>

ts::FixedPoint< INT_T, PREC >::FixedPoint ( INT2 i )

inline

Constructor.

Template Parameters

INT2	Some other integer type (signed or unsigned).

Parameters

[in] i Initial value in integral number of units which is converted into the fixed-precision representation.

◆ FixedPoint() [3/3]

template<typename INT_T, const size_t PREC>

ts::FixedPoint< INT_T, PREC >::FixedPoint	(	int_t	i,
		bool	raw )

inline

Constructor.

Parameters

[in]	i	Initial value. Interpreted according to raw.
[in]	raw	If true, the value i is a raw underlying internal value, without conversion. If false, the value i is an integral number of units which is converted into the fixed-precision representation.

Member Function Documentation

◆ description()

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

ts::UString ts::FixedPoint< INT_T, PREC >::description ( ) const

overridevirtual

Get a textual description of the values of that type. This is typically used in help texts.

Returns: A textual description of the values of that type.

Implements ts::AbstractNumber.

◆ inRange()

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

bool ts::FixedPoint< INT_T, PREC >::inRange	(	int64_t	min,
		int64_t	max ) const

overridevirtual

Check if the value of the number is within a range of integer value.

Parameters

[in]	min	Minimum integer value (inclusive).
[in]	max	Maximum integer value (inclusive).

Returns: True if this number is within the range min to max, inclusive.

Implements ts::AbstractNumber.

◆ toInt64()

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

int64_t ts::FixedPoint< INT_T, PREC >::toInt64 ( ) const

overridevirtual

Conversion to a 64-bit signed integer value.

Returns: The value in integral units. Underflow or overflow rounding is applied when necessary.

Implements ts::AbstractNumber.

◆ toDouble()

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

double ts::FixedPoint< INT_T, PREC >::toDouble ( ) const

overridevirtual

Conversion to double value.

Returns: The value as a double.

Implements ts::AbstractNumber.

◆ fromString()

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

bool ts::FixedPoint< INT_T, PREC >::fromString	(	const UString &	str,
		UChar	separator = COMMA,
		UChar	decimal_dot = FULL_STOP )

overridevirtual

Parse a string and interpret it as a number. The content of this object is updated from the parsed string.

Parameters

[in]	str	A string to parse, representing this object.
[in]	separator	Separator character for groups of thousands, a comma by default.
[in]	decimal_dot	The decimal separator, a dot by default.

Returns: True if the str is valid, false otherwise. In case of parsing error, the content of this object is undefined.

Implements ts::AbstractNumber.

◆ toString()

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

ts::UString ts::FixedPoint< INT_T, PREC >::toString	(	size_t	min_width = 0,
		bool	right_justified = true,
		UChar	separator = COMMA,
		bool	force_sign = false,
		size_t	decimals = NPOS,
		bool	force_decimals = false,
		UChar	decimal_dot = FULL_STOP,
		UChar	pad = SPACE ) const

overridevirtual

Convert the number to a string object.

Parameters

[in]	min_width	Minimum width of the returned string. Padded with pad characters if larger than the number of characters in the formatted number.
[in]	right_justified	If true (the default), return a right-justified string. When false, return a left-justified string. Ignored if min_width is lower than the number of characters in the formatted number.
[in]	separator	Separator character for groups of thousands, a comma by default. CHAR_NULL means no separator.
[in]	force_sign	If true, force a '+' sign for positive values.
[in]	decimals	Precision to use after the decimal point. NPOS means default.
[in]	force_decimals	If true, with positive precision, force a decimal dot and the number of decimal digits of the precision. By default, skip non significant decimal digits.
[in]	decimal_dot	The decimal separator, a dot by default.
[in]	pad	The padding character to adjust the width.

Returns: The formatted string.

Implements ts::AbstractNumber.

◆ toInt()

template<typename INT_T, const size_t PREC>

int_t ts::FixedPoint< INT_T, PREC >::toInt ( ) const

inline

Conversion to integral units.

Returns: The value in integral units. Underflow or overflow rounding is applied when necessary.

◆ raw()

template<typename INT_T, const size_t PREC>

int_t ts::FixedPoint< INT_T, PREC >::raw ( ) const

inline

Get the internal unconverted integer value.

Returns: The internal unconverted integer value.

◆ abs()

template<typename INT_T, const size_t PREC>

FixedPoint ts::FixedPoint< INT_T, PREC >::abs ( ) const

inline

Get the absolute value.

Returns: The absolute value of this fixed-point number.

◆ max()

template<typename INT_T, const size_t PREC>

FixedPoint ts::FixedPoint< INT_T, PREC >::max ( const FixedPoint< INT_T, PREC > & x ) const

inline

Get the maximum value of two fixed-point numbers.

Parameters

[in] x Another fixed-point number.

Returns: The maximum value of this fixed-point number and x.

◆ min()

template<typename INT_T, const size_t PREC>

FixedPoint ts::FixedPoint< INT_T, PREC >::min ( const FixedPoint< INT_T, PREC > & x ) const

inline

Get the minimum value of two fixed-point numbers.

Parameters

[in] x Another fixed-point number.

Returns: The minimum value of this fixed-point number and x.

◆ mulOverflow() [1/2]

template<typename INT_T, const size_t PREC>

template<typename INT2>
requires std::integral<INT2>

bool ts::FixedPoint< INT_T, PREC >::mulOverflow ( INT2 x ) const

inline

Check if this fixed-point number generates an overflow when multiplied by an integer.

Template Parameters

INT2	Another integer type.

Parameters

[in] x An integer of type INT2.

Returns: True if this fixed-point number generates an overflow when multiplied by x.

◆ mulOverflow() [2/2]

template<typename INT_T, const size_t PREC>

bool ts::FixedPoint< INT_T, PREC >::mulOverflow ( const FixedPoint< INT_T, PREC > & x ) const

inline

Check if this fixed-point number generates an overflow when multiplied by another fixed-point.

Parameters

[in] x Another fixed-point number.

Returns: True if this fixed-point number generates an overflow when multiplied by x.

◆ divOverflow()

template<typename INT_T, const size_t PREC>

bool ts::FixedPoint< INT_T, PREC >::divOverflow ( const FixedPoint< INT_T, PREC > & x ) const

inline

Check if this fixed-point number generates an overflow when divided by another fixed-point.

Parameters

[in] x Another fixed-point.

Returns: True if this fixed-point generates an overflow when divided by x.

◆ Format()

void ts::AbstractNumber::Format	(	UString &	str,
		size_t	min_width,
		bool	right_justified,
		UChar	separator,
		bool	add_plus_sign,
		size_t	decimals,
		bool	force_decimals,
		UChar	decimal_dot,
		UChar	pad )

staticprotectedinherited

Static common utility to format a string containing a number with or without decimal part.

Parameters

[in,out]	str	String to format.
[in]	min_width	Minimum width of the string.
[in]	right_justified	If true (the default), return a right-justified string.
[in]	separator	Separator character for groups of thousands.
[in]	add_plus_sign	If true, force a '+' sign before the number.
[in]	decimals	Precision to use after the decimal point. NPOS not allowed.
[in]	force_decimals	If true, force a decimal dot and the number of decimal digits. For integer types, use force_decimals == true and decimals == 0.
[in]	decimal_dot	The decimal separator.
[in]	pad	The padding character to adjust the width.

◆ Deformat()

void ts::AbstractNumber::Deformat	(	UString &	str,
		UChar	separator,
		UChar	decimal_dot )

staticprotectedinherited

Static common utility to deformat a string containing a number.

Parameters

[in,out]	str	String to deformat.
[in]	separator	Separator character for groups of thousands.
[in]	decimal_dot	The decimal separator.

Member Data Documentation

◆ PRECISION

template<typename INT_T, const size_t PREC>

size_t ts::FixedPoint< INT_T, PREC >::PRECISION = PREC

staticconstexpr

The precision of the fixed number type (number of decimal digits).

◆ FACTOR

template<typename INT_T, const size_t PREC>

int_t ts::FixedPoint< INT_T, PREC >::FACTOR = ts::static_power10<int_t, PRECISION>::value

staticconstexpr

The factor to convert between FixedPoint and int_t (10**PRECISION).

◆ MIN

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

const ts::FixedPoint< INT_T, PREC > ts::FixedPoint< INT_T, PREC >::MIN

static

The minimum representable value of this fixed-point type.

◆ MAX

template<typename INT_T, const size_t PREC>
requires std::signed_integral<INT_T>

const ts::FixedPoint< INT_T, PREC > ts::FixedPoint< INT_T, PREC >::MAX

static

The maximum representable value of this fixed-point type.

◆ INVALID

const AbstractNumber* const ts::AbstractNumber::INVALID

staticinherited

Pointer to an invalid instance of AbstractNumber. Its toString() method always return an empty string.

The documentation for this class was generated from the following file:

tsFixedPoint.h

Public Types

Public Member Functions

Static Public Attributes

Static Protected Member Functions

Detailed Description

Member Typedef Documentation

◆ int_t

Constructor & Destructor Documentation

◆ FixedPoint() [1/3]

◆ FixedPoint() [2/3]

◆ FixedPoint() [3/3]

Member Function Documentation

◆ description()

◆ inRange()

◆ toInt64()

◆ toDouble()

◆ fromString()

◆ toString()

◆ toInt()

◆ raw()

◆ abs()

◆ max()

◆ min()

◆ mulOverflow() [1/2]

◆ mulOverflow() [2/2]

◆ divOverflow()

◆ Format()

◆ Deformat()

Member Data Documentation

◆ PRECISION

◆ FACTOR

◆ MIN

◆ MAX

◆ INVALID