Implementation of double value manipulator with fixed-point arithmetic and rounding. More...

#include <CFixedPointManip.h>

Inheritance diagram for imath::CFixedPointManip:

Public Types
enum	RoundingType { RT_NORMAL , RT_FLOOR , RT_CEIL , RT_LAST = RT_CEIL + 1 }

typedef CDoubleManip	BaseClass

Public Member Functions
	CFixedPointManip (int precision=1, RoundingType roundingType=RT_NORMAL)

void	SetPrecision (int precision)
	Set fixed point precision.

RoundingType	GetRoundingType () const
	Get type of rounding.

void	SetRoundingType (RoundingType roundingType)
	Set type of rounding.

virtual int	GetPrecision () const override
	Get number of digits after point.

virtual double	GetRounded (const double &value) const override
	Get the nearest value rounded used this arithmetik.

virtual bool	AreValuesEqual (const double &value1, const double &value2) const override
	Compare two values and check, if there are equal.

virtual bool	IsSmaller (const double &value1, const double &value2) const override
	Compare two values and check, if first one is smaller as the second.

virtual bool	IsSmallerEqual (const double &value1, const double &value2) const override
	Compare two values and check, if first one is smaller or equal as the second.

virtual double	GetSmallerValue (const double &value) const override
	Return biggest value smaller that specified one.

virtual double	GetBiggerValue (const double &value) const override
	Return smallest value bigger that specified one.

virtual QString	GetString (const double &value) const override
	Get this value as string.

virtual bool	GetParsed (const QString &text, double &result) const override
	Get value converted from string.

Public Member Functions inherited from imath::CDoubleManip
	CDoubleManip ()

char	GetPointChar () const
	Get point character.

void	SetPointChar (char pointChar)
	Set point character.

Public Member Functions inherited from istd::IPolymorphic
virtual	~IPolymorphic ()

Protected Types
typedef int(*	RoundingFuntionPtr) (qreal value)

Protected Types inherited from imath::CDoubleManip
enum	{ PRECISION = 6 }

Protected Member Functions
virtual qint32	GetInternalValue (double value) const

virtual double	GetNormalValue (qint32 intValue) const

QString	GetString (const double &value, int precision) const

Detailed Description

Implementation of double value manipulator with fixed-point arithmetic and rounding.

Purpose

CFixedPointManip provides manipulation of double precision values with fixed decimal precision, simulating fixed-point arithmetic. It rounds values to a specified number of decimal places and ensures consistent behavior for financial calculations, user interfaces, and scenarios where exact decimal representation is required. Extends CDoubleManip with configurable precision and rounding modes.

Key Features

Fixed Precision: Rounds to specified decimal places (1 = 0.1, 2 = 0.01, etc.)
Rounding Modes: Normal (nearest), floor (down), ceil (up)
Consistent Arithmetic: All operations respect the fixed precision
String Formatting: Shows exactly the configured precision
Comparison: Compares rounded values (tolerance implicit in precision)
Increment/Decrement: Steps by the minimum precision unit

Rounding Modes

RT_NORMAL** - Mathematical rounding (nearest value, 0.5 rounds up):

1.234 -> 1.23 (precision=2)
1.235 -> 1.24 (precision=2)

RT_FLOOR** - Always round toward negative infinity:
1.239 -> 1.23 (precision=2)
-1.231 -> -1.24 (precision=2)

RT_CEIL** - Always round toward positive infinity:
1.231 -> 1.24 (precision=2)
-1.239 -> -1.23 (precision=2)

Usage Examples

// Create manipulator for currency (2 decimal places)
imath::CFixedPointManip moneyManip(2, imath::CFixedPointManip::RT_NORMAL);
 
// Rounding
double rounded = moneyManip.GetRounded(3.14159);  // 3.14
 
// String formatting (shows exact precision)
QString str = moneyManip.GetString(5.1);  // "5.10" (always 2 decimals)
 
// Comparison (rounds before comparing)
bool equal = moneyManip.AreValuesEqual(1.234, 1.235);  // true (both -> 1.24)
bool less = moneyManip.IsSmaller(1.231, 1.235);  // true (1.23 < 1.24)
 
// Increment/decrement by precision
double bigger = moneyManip.GetBiggerValue(5.10);  // 5.11 (step = 0.01)
double smaller = moneyManip.GetSmallerValue(5.10);  // 5.09
 
// Parse with rounding
double value;
moneyManip.GetParsed("3.14159", value);  // value = 3.14 (rounded)
 
// Different precisions
imath::CFixedPointManip manip0(0);  // Integer (precision = 1)
imath::CFixedPointManip manip1(1);  // One decimal (precision = 0.1)
imath::CFixedPointManip manip3(3);  // Three decimals (precision = 0.001)
 
manip0.GetRounded(3.7);  // 4.0
manip1.GetRounded(3.74);  // 3.7
manip3.GetRounded(3.1416);  // 3.142
 
// Rounding mode comparison
imath::CFixedPointManip normal(2, imath::CFixedPointManip::RT_NORMAL);
imath::CFixedPointManip floor(2, imath::CFixedPointManip::RT_FLOOR);
imath::CFixedPointManip ceil(2, imath::CFixedPointManip::RT_CEIL);
 
normal.GetRounded(1.235);  // 1.24
floor.GetRounded(1.235);   // 1.23
ceil.GetRounded(1.235);    // 1.24
 
normal.GetRounded(-1.235); // -1.24
floor.GetRounded(-1.235);  // -1.24 (toward -infinity)
ceil.GetRounded(-1.235);   // -1.23 (toward +infinity)

Common Use Cases

Financial/Currency Applications**:

Always use precision=2 (cents/pence)
Prevents floating-point rounding errors
Ensures consistent display ($1.50, not $1.5)

User Interface Controls**:
Spinboxes with fixed step size
Sliders with discrete positions
Display fields with consistent formatting

Fixed-Resolution Measurements**:
Instruments with limited resolution (0.1mm, 0.01V)
Quantized values from hardware

Scientific Data with Fixed Precision**:
Laboratory measurements with known precision
Sensor data with fixed decimal resolution

CFixedPointManip vs CDoubleManip

CFixedPointManip: Rounds to fixed precision, predictable for UI/financial
CDoubleManip: Full precision, no rounding, for scientific calculations

Precision Parameter

The precision parameter represents the number of decimal places:

precision=0: Integer values (1, 2, 3, ...)
precision=1: One decimal place (1.0, 1.1, 1.2, ...)
precision=2: Two decimal places (1.00, 1.01, 1.02, ...)
precision=n: n decimal places

See also: imath::CDoubleManip, imath::IDoubleManip, imath::CDouble, imath::TIValueManip

Definition at line 126 of file CFixedPointManip.h.

Member Typedef Documentation

◆ BaseClass

typedef CDoubleManip imath::CFixedPointManip::BaseClass

Definition at line 129 of file CFixedPointManip.h.

◆ RoundingFuntionPtr

typedef int(* imath::CFixedPointManip::RoundingFuntionPtr) (qreal value)

protected

Definition at line 177 of file CFixedPointManip.h.

Member Enumeration Documentation

◆ RoundingType

enum imath::CFixedPointManip::RoundingType

Enumerator
RT_NORMAL	Normal mathematical rounding to the nearest value.
RT_FLOOR	Rounding down.
RT_CEIL	Rounding up.
RT_LAST

Definition at line 131 of file CFixedPointManip.h.

Constructor & Destructor Documentation

◆ CFixedPointManip()

imath::CFixedPointManip::CFixedPointManip	(	int	precision = `1`,
		RoundingType	roundingType = `RT_NORMAL`
	)

Member Function Documentation

◆ AreValuesEqual()

bool imath::CFixedPointManip::AreValuesEqual	(	const double &	value1,
		const double &	value2
	)		const

inlineoverridevirtual

Compare two values and check, if there are equal.

Parameters

value1	first value.
value2	second value.

Reimplemented from imath::CDoubleManip.

Definition at line 210 of file CFixedPointManip.h.

References GetInternalValue().

◆ GetBiggerValue()

double imath::CFixedPointManip::GetBiggerValue ( const double & value ) const

inlineoverridevirtual

Return smallest value bigger that specified one.

Reimplemented from imath::CDoubleManip.

Definition at line 234 of file CFixedPointManip.h.

References GetInternalValue(), and GetNormalValue().

◆ GetInternalValue()

qint32 imath::CFixedPointManip::GetInternalValue ( double value ) const

inlineprotectedvirtual

Reimplemented in imath::CComplexDoubleManip.

Definition at line 242 of file CFixedPointManip.h.

Referenced by AreValuesEqual(), GetBiggerValue(), GetRounded(), GetSmallerValue(), IsSmaller(), and IsSmallerEqual().

◆ GetNormalValue()

double imath::CFixedPointManip::GetNormalValue ( qint32 intValue ) const

inlineprotectedvirtual

Definition at line 250 of file CFixedPointManip.h.

Referenced by GetBiggerValue(), GetRounded(), and GetSmallerValue().

◆ GetParsed()

virtual bool imath::CFixedPointManip::GetParsed	(	const QString &	text,
		double &	result
	)		const

overridevirtual

Get value converted from string.

Parameters

text	input string.
result	result value.

Returns: true if success.

Reimplemented from imath::CDoubleManip.

Reimplemented in imath::CComplexDoubleManip.

◆ GetPrecision()

virtual int imath::CFixedPointManip::GetPrecision ( ) const

overridevirtual

Get number of digits after point.

Reimplemented from imath::CDoubleManip.

Referenced by imath::CComplexDoubleManip::SetPrecision(), and imath::CComplexDoubleManip::SetScaleFactor().

◆ GetRounded()

double imath::CFixedPointManip::GetRounded ( const double & value ) const

inlineoverridevirtual

Get the nearest value rounded used this arithmetik.

Reimplemented from imath::CDoubleManip.

Definition at line 204 of file CFixedPointManip.h.

References GetInternalValue(), and GetNormalValue().

◆ GetRoundingType()

CFixedPointManip::RoundingType imath::CFixedPointManip::GetRoundingType ( ) const

inline

Get type of rounding.

Definition at line 196 of file CFixedPointManip.h.

◆ GetSmallerValue()

double imath::CFixedPointManip::GetSmallerValue ( const double & value ) const

inlineoverridevirtual

Return biggest value smaller that specified one.

Reimplemented from imath::CDoubleManip.

Definition at line 228 of file CFixedPointManip.h.

References GetInternalValue(), and GetNormalValue().

◆ GetString() [1/2]

virtual QString imath::CFixedPointManip::GetString ( const double & value ) const

overridevirtual

Get this value as string.

Parameters

value value will be converted.

Reimplemented from imath::CDoubleManip.

Reimplemented in imath::CComplexDoubleManip.

◆ GetString() [2/2]

QString imath::CFixedPointManip::GetString	(	const double &	value,
		int	precision
	)		const

protected

◆ IsSmaller()

bool imath::CFixedPointManip::IsSmaller	(	const double &	value1,
		const double &	value2
	)		const

inlineoverridevirtual

Compare two values and check, if first one is smaller as the second.

Parameters

value1	first value.
value2	second value.

Reimplemented from imath::CDoubleManip.

Definition at line 216 of file CFixedPointManip.h.

References GetInternalValue().

◆ IsSmallerEqual()

bool imath::CFixedPointManip::IsSmallerEqual	(	const double &	value1,
		const double &	value2
	)		const

inlineoverridevirtual

Compare two values and check, if first one is smaller or equal as the second.

Parameters

value1	first value.
value2	second value.

Reimplemented from imath::CDoubleManip.

Definition at line 222 of file CFixedPointManip.h.

References GetInternalValue().

◆ SetPrecision()

void imath::CFixedPointManip::SetPrecision ( int precision )

Set fixed point precision.

Referenced by imath::CComplexDoubleManip::SetPrecision().

◆ SetRoundingType()

void imath::CFixedPointManip::SetRoundingType ( RoundingType roundingType )

Set type of rounding.

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

Acf/Include/imath/CFixedPointManip.h

Public Types

Public Member Functions

Protected Types

Protected Member Functions

Detailed Description

Purpose

Key Features

Rounding Modes

Usage Examples

Common Use Cases

CFixedPointManip vs CDoubleManip

Precision Parameter

Member Typedef Documentation

◆ BaseClass

◆ RoundingFuntionPtr

Member Enumeration Documentation

◆ RoundingType

Constructor & Destructor Documentation

◆ CFixedPointManip()

Member Function Documentation

◆ AreValuesEqual()

◆ GetBiggerValue()

◆ GetInternalValue()

◆ GetNormalValue()

◆ GetParsed()

◆ GetPrecision()

◆ GetRounded()

◆ GetRoundingType()

◆ GetSmallerValue()

◆ GetString() [1/2]

◆ GetString() [2/2]

◆ IsSmaller()

◆ IsSmallerEqual()

◆ SetPrecision()

◆ SetRoundingType()