Module io.github.tonywasher.joceanus.oceanus

Package io.github.tonywasher.joceanus.oceanus.decimal

Class OceanusNewDecimal

java.lang.Object

io.github.tonywasher.joceanus.oceanus.decimal.OceanusNewDecimal

public class OceanusNewDecimal
extends Object

Decimal class performing integer arithmetic on large decimals.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	MAX_DECIMALS	The Maximum # of Decimals.

Constructor Summary

Constructors

Constructor	Description
OceanusNewDecimal(int pScale)	Constructor.
OceanusNewDecimal(long pIntegral, int pFractional, int pSign, int pScale)	Constructor.
OceanusNewDecimal(BigDecimal pSource)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	add(OceanusNewDecimal pDecimal)	Add a decimal to value.
void	divide(OceanusNewDecimal pDivisor)	Divide by another decimal.
int	fractionalValue()	Obtain the fractional part of the decimal.
long	integralValue()	Obtain the integral part of the decimal.
void	multiply(OceanusNewDecimal pMultiplicand)	Multiply by another decimal
int	scale()	Obtain the scale of the decimal.
int	signum()	Obtain the sign of the decimal.
void	subtract(OceanusNewDecimal pDecimal)	Subtract a decimal from value.
BigDecimal	toBigDecimal()	Convert to BigDecimal.
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

MAX_DECIMALS

public static final int MAX_DECIMALS

The Maximum # of Decimals.

See Also:

• Constant Field Values

Constructor Details

OceanusNewDecimal

public OceanusNewDecimal(int pScale)

Constructor.

Parameters:

pScale - the number of decimal digits

OceanusNewDecimal

public OceanusNewDecimal(BigDecimal pSource)

Constructor.

Parameters:

pSource - the source BigDecimal

OceanusNewDecimal

public OceanusNewDecimal(long pIntegral,
 int pFractional,
 int pSign,
 int pScale)

Constructor.

Parameters:

pIntegral - the integral part of the decimal.

pFractional - the fractional part of the decimal

pSign - the sign of the decimal

pScale - the number of decimal digits

Method Details

integralValue

public long integralValue()

Obtain the integral part of the decimal.

Returns:

the integral part of the decimal

signum

public int signum()

Obtain the sign of the decimal.

Returns:

-1, 0, or 1 as the value of this Decimal is negative, zero, or positive

fractionalValue

public int fractionalValue()

Obtain the fractional part of the decimal.

Returns:

the fractional part of the decimal

scale

public int scale()

Obtain the scale of the decimal.

Returns:

the scale of the decimal

add

public void add(OceanusNewDecimal pDecimal)

Add a decimal to value.

Parameters:

pDecimal - the decimal to add to this value

subtract

public void subtract(OceanusNewDecimal pDecimal)

Subtract a decimal from value.

Parameters:

pDecimal - the decimal to subtract from this value

multiply

public void multiply(OceanusNewDecimal pMultiplicand)

Multiply by another decimal

This function splits the values into three separate integers and then performs long arithmetic to prevent loss of precision. The value is represented as (x,y,z,s) where the decimal may be written as x*2³² + y + z*10^-s and x,y,z,s are all integers.

The product of (x₁, y₁, z₁, s) by (x₂, y₂, z₂, t) is therefore x₁*x₂*2⁶⁴ (discardable) + (x₁*y₂ + x₂*y₁)*2³² + x₂*y₂ + x₁*z₂*2³²*10^-t + x₂*z₁*2³²*10^-s + y₁*z₂*10^-t + y₂*z₁*10^-s + z₁*z₂*10^-s-t

Parameters:

pMultiplicand - the decimal to multiply by

divide

public void divide(OceanusNewDecimal pDivisor)

Divide by another decimal.

This function uses BigDecimal to perform the calculation

Parameters:

pDivisor - the decimal to divide by

toBigDecimal

public BigDecimal toBigDecimal()

Convert to BigDecimal.

Returns:

the BigDecimal equivalent

toString

public String toString()

Overrides:

toString in class Object