User Interface class. More...

#include <ilviews/dataccess/decimal.h>

Public Member Functions
	IliDecimal ()
	This constructor initializes a decimal with an initial value of zero.

	IliDecimal (const IliDecimal &)
	This is the copy constructor of the `IliDecimal` class.

	IliDecimal (IlDouble val)
	This constructor initializes a decimal with an initial value. More...

	IliDecimal (IlInt val)
	This constructor initializes a decimal with an initial value. More...

IliDecimal	abs () const
	Returns the absolute value of the decimal. More...

IlDouble	asDouble () const
	Returns a double value. More...

IlInt	asInt () const
	Returns a integer value. More...

int	compareTo (const IliDecimal &dec) const
	Compares two decimals. More...

IlInt	getPrecision () const
	Returns the precision of the decimal. More...

IlInt	getScale () const
	Returns the scale of the decimal. More...

IlInt	getSign () const
	Returns the sign of the value. More...

int	operator!= (const IliDecimal &dec) const
	Compares two decimals. More...

IliDecimal	operator* (const IliDecimal &dec) const
	Returns the product of the both decimals. More...

IliDecimal	operator+ (const IliDecimal &dec) const
	Returns the sum of the both decimals. More...

IliDecimal	operator- () const
	Returns the opposite value of the decimal. More...

IliDecimal	operator- (const IliDecimal &dec) const
	Returns the difference of the both decimals. More...

int	operator< (const IliDecimal &dec) const
	Compares two decimals. More...

int	operator<= (const IliDecimal &dec) const
	Compares two decimals. More...

const IliDecimal &	operator= (const IliDecimal &dec)
	Assigns another decimal object to the decimal object. More...

const IliDecimal &	operator= (IlDouble val)
	Assigns a double value to the decimal object. More...

const IliDecimal &	operator= (IlInt val)
	Assigns an integer value to the decimal object. More...

int	operator== (const IliDecimal &dec) const
	Compares two decimals. More...

int	operator> (const IliDecimal &dec) const
	Compares two decimals. More...

int	operator>= (const IliDecimal &dec) const
	Compares two decimals. More...

IlBoolean	setString (const char *value)
	Assigns a string value. More...

IlBoolean	toDouble (IlDouble &val) const
	Returns a double value. More...

IlBoolean	toInteger (IlInt &buff) const
	Returns an integer value. More...

char *	toString (char *buffer, int size) const
	Writes the value of the decimal in base 10 to a buffer. More...

Detailed Description

User Interface class.

Library: dataccess

The IliDecimal class is used to hold fixed-point numbers with up to 38 digits of precision (internally represented in base 10). This contrasts with the C++ double type that represents floating-point numbers in base 2 and that has a machine-dependent precision (typically 15 digits).

See also: IliValue.

Accessors\nAccessors provide a scriptable and uniform way to inspect and modify an object by using its base class methods <tt>IlvValueInterface::queryValue()</tt>, <tt>IlvValueInterface::queryValues()</tt>, <tt>IlvValueInterface::changeValue()</tt>, <tt>IlvValueInterface::changeValues()</tt>.\n\nThis class defines the following accessors:

Data accessors

Name	Type	Equivalent methods
`sign`	Int	`getSign()`

Method accessors

Name	Return type	Equivalent methods
`toNumber()`	Double	`asDouble()`
`toString()`	String	`toString()`
`abs()`	Object	`abs()`
`negate()`	Object	`operator-()`
`compareTo(Object d)`	Int	`compareTo(d)`
`add(Object d)`	Object	`operator+(d)`
`substract(Object d)`	Object	`operator-(d)`
`multiply(Object d)`	Object	`operator*(d)`

Constructor & Destructor Documentation

◆ IliDecimal() [1/2]

IliDecimal::IliDecimal ( IlInt val )

This constructor initializes a decimal with an initial value.

Parameters

val	The initial value.

◆ IliDecimal() [2/2]

IliDecimal::IliDecimal ( IlDouble val )

This constructor initializes a decimal with an initial value.

Note that since the value is a double type (internally represented in base 2), the resulting value of the decimal may differ slightly due to rounding during the conversion.

Parameters

val	The initial value.

Member Function Documentation

◆ abs()

IliDecimal IliDecimal::abs ( ) const

Returns the absolute value of the decimal.

Returns: The absolute value of the decimal.

◆ asDouble()

IlDouble IliDecimal::asDouble ( ) const

Returns a double value.

Returns: The corresponding double if the value can be stored into a double without loss of precision. Otherwise, it returns 0.

◆ asInt()

IlInt IliDecimal::asInt ( ) const

Returns a integer value.

Returns: The corresponding integer if the value of the decimal is an integer and if it can be stored into an int without loss of precision. Otherwise, it returns 0.

◆ compareTo()

int IliDecimal::compareTo ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: +1 if the decimal is greater than dec, 0 if they are equal, and -1 if the decimal is less than dec.

◆ getPrecision()

IlInt IliDecimal::getPrecision ( ) const

Returns the precision of the decimal.

This is the number of digits needed to represent its value in base 10.

Returns: The precision.

◆ getScale()

IlInt IliDecimal::getScale ( ) const

Returns the scale of the decimal.

This is the number of digits that fall after the decimal point when represented in base 10.

Returns: The scale.

◆ getSign()

IlInt IliDecimal::getSign ( ) const

Returns the sign of the value.

Returns: +1 if the value of the decimal is positive, 0 if it is zero, and -1 if it is negative.

◆ operator!=()

int IliDecimal::operator!= ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: 1 if the decimals are not equal, otherwise 0.

◆ operator*()

IliDecimal IliDecimal::operator* ( const IliDecimal & dec ) const

Returns the product of the both decimals.

Parameters

dec	The second decimal.

Returns: The product of the both decimals.

◆ operator+()

IliDecimal IliDecimal::operator+ ( const IliDecimal & dec ) const

Returns the sum of the both decimals.

Parameters

dec	The second decimal.

Returns: The sum of the both decimal objects.

◆ operator-() [1/2]

IliDecimal IliDecimal::operator- ( ) const

Returns the opposite value of the decimal.

Returns: The opposite value of the decimal.

◆ operator-() [2/2]

IliDecimal IliDecimal::operator- ( const IliDecimal & dec ) const

Returns the difference of the both decimals.

Parameters

dec	The second decimal.

Returns: The difference of the both decimals.

◆ operator<()

int IliDecimal::operator< ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: 1 if the decimal is smaller than the second decimal, otherwise 0.

◆ operator<=()

int IliDecimal::operator<= ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: 1 if the decimal is smaller or equal than the second decimal, otherwise 0.

◆ operator=() [1/3]

const IliDecimal& IliDecimal::operator= ( const IliDecimal & dec )

Assigns another decimal object to the decimal object.

Parameters

dec	The new value.

Returns: The modified object.

◆ operator=() [2/3]

const IliDecimal& IliDecimal::operator= ( IlDouble val )

Assigns a double value to the decimal object.

Note that since the value is a double (internally represented in base 2), the resulting value of the decimal may differ slightly due to rounding during conversion.

Parameters

val	The new value.

Returns: The modified object.

◆ operator=() [3/3]

const IliDecimal& IliDecimal::operator= ( IlInt val )

Assigns an integer value to the decimal object.

Parameters

val	The new value.

Returns: The modified object.

◆ operator==()

int IliDecimal::operator== ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: 1 if the decimals are equal, otherwise 0.

◆ operator>()

int IliDecimal::operator> ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: 1 if the decimal is greater than the second decimal, otherwise 0.

◆ operator>=()

int IliDecimal::operator>= ( const IliDecimal & dec ) const

Compares two decimals.

Parameters

dec	The second decimal.

Returns: 1 if the decimal is greater or equal than the second decimal, otherwise 0.

◆ setString()

IlBoolean IliDecimal::setString ( const char * value )

Assigns a string value.

Parameters

value The representation in base 10 of a decimal number using the following syntax: [-|+]{digit}*[.[{digit}*]] or [-|+]{digit}+[.[{digit}*]][{E|e}[-|+]{digit}+]

Returns: IlTrue if successful.

◆ toDouble()

IlBoolean IliDecimal::toDouble ( IlDouble & val ) const

Returns a double value.

If the value of the decimal can be stored into a double without loss of precision, this member function stores the value of the decimal into the buffer.

Parameters

val	The buffer which contains the double value.

Returns: IlTrue. Otherwise, it returns IlFalse.

◆ toInteger()

IlBoolean IliDecimal::toInteger ( IlInt & buff ) const

Returns an integer value.

If the value of the decimal is an integer and can be stored into an int without loss of precision, this member function stores the value of this decimal into the buffer.

Parameters

buff	The buffer which contains the integer value.

Returns: IlTrue. Otherwise, it returns IlFalse.

◆ toString()

char* IliDecimal::toString	(	char *	buffer,
		int	size
	)		const

Writes the value of the decimal in base 10 to a buffer.

Parameters

buffer	Point to the character string.
size	The string maximum size.

Returns: The buffer.

Public Member Functions

Detailed Description

Data accessors

Method accessors

Constructor & Destructor Documentation

◆ IliDecimal() [1/2]

◆ IliDecimal() [2/2]

Member Function Documentation

◆ abs()

◆ asDouble()

◆ asInt()

◆ compareTo()

◆ getPrecision()

◆ getScale()

◆ getSign()

◆ operator!=()

◆ operator*()

◆ operator+()

◆ operator-() [1/2]

◆ operator-() [2/2]

◆ operator<()

◆ operator<=()

◆ operator=() [1/3]

◆ operator=() [2/3]

◆ operator=() [3/3]

◆ operator==()

◆ operator>()

◆ operator>=()

◆ setString()

◆ toDouble()

◆ toInteger()

◆ toString()