org.hl7.fhir.utilities.ucum

Class Decimal

java.lang.Object

org.hl7.fhir.utilities.ucum.Decimal

public class Decimal
extends Object

Precision aware Decimal implementation. Any size number with any number of significant digits is supported. Note that operations are precision aware operations. Note that whole numbers are assumed to have unlimited precision. For example: 2 x 2 = 4 2.0 x 2.0 = 4.0 2.00 x 2.0 = 4.0 and 10 / 3 = 3.33333333333333333333333333333333333333333333333 10.0 / 3 = 3.33 10.00 / 3 = 3.333 10.00 / 3.0 = 3.3 10 / 3.0 = 3.3 Addition 2 + 0.001 = 2.001 2.0 + 0.001 = 2.0 Note that the string representation is precision limited, but the internal representation is not. This class is defined to work around the limitations of Java Big Decimal

Author:

Grahame

Constructor Summary

Constructors

Constructor and Description
Decimal(int i)
Decimal(String value)
Decimal(String value, int precision) There are a few circumstances where a simple value is known to be correct to a high precision.

Method Summary

Modifier and Type	Method and Description
Decimal	add(Decimal other)
String	asDecimal()
int	asInteger()
String	asScientific()
int	comparesTo(Decimal other)
Decimal	copy()
Decimal	divide(Decimal other)
Decimal	divInt(Decimal other)
boolean	equals(Decimal other)
boolean	equals(Decimal value, Decimal maxDifference)
boolean	isOne()
boolean	isWholeNumber()
boolean	isZero()
Decimal	modulo(Decimal other)
Decimal	multiply(Decimal other)
static Decimal	one()
Decimal	subtract(Decimal other)
String	toString()
Decimal	trunc()
static Decimal	zero()

Methods inherited from class java.lang.Object

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

Constructor Detail

Decimal

public Decimal(String value)
        throws UcumException

Throws:

UcumException

Decimal

public Decimal(String value,
               int precision)
        throws UcumException

There are a few circumstances where a simple value is known to be correct to a high precision. For instance, the unit prefix milli is not ~0.001, it is precisely 0.001 to whatever precision you want to specify. This constructor allows you to specify an alternative precision than the one implied by the stated string

Parameters:

value - - a string representation of the value

precision - - a

Throws:

UcumException

Decimal

public Decimal(int i)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

copy

public Decimal copy()

zero

public static Decimal zero()

isZero

public boolean isZero()

one

public static Decimal one()

isOne

public boolean isOne()

equals

public boolean equals(Decimal other)

comparesTo

public int comparesTo(Decimal other)

isWholeNumber

public boolean isWholeNumber()

asDecimal

public String asDecimal()

asInteger

public int asInteger()
              throws UcumException

Throws:

UcumException

asScientific

public String asScientific()

trunc

public Decimal trunc()

add

public Decimal add(Decimal other)

subtract

public Decimal subtract(Decimal other)

multiply

public Decimal multiply(Decimal other)

divide

public Decimal divide(Decimal other)
               throws UcumException

Throws:

UcumException

divInt

public Decimal divInt(Decimal other)
               throws UcumException

Throws:

UcumException

modulo

public Decimal modulo(Decimal other)
               throws UcumException

Throws:

UcumException

equals

public boolean equals(Decimal value,
                      Decimal maxDifference)