Decimal (Java API Reference for Oracle WebLogic Server)

java.lang.Object
- java.lang.Number
- - weblogic.wtc.jatmi.Decimal

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable
```
public class Decimal
extends java.lang.Number
implements java.lang.Comparable
```
This class provides a Java implementation of the Tuxedo packed decimal type. Packed decimals appear only in Tuxedo View buffers. The class methods provide convenience routines to create packed decimals from Strings and numbers and to convert a packed decimal object to a String or number. A Decimal encodes a number as an array of bytes in base-100 and a signed exponent (-64 to +63). The byte array is of fixed size with the implied decimal point to the left of the first byte. The exponent represents powers of 100. A special exponent value DECPOSNULL indicates a Decimal with null (undefined) value.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field	Description
`static int`	`DECPOSNULL`	Exponent value indicating a null `Decimal`, i.e., a `Decimal` with undefined value.
`static int`	`DECSIZE`	Size of the array of bytes representing the digits of the `Decimal`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`java.math.BigDecimal`	`bigDecimalValue()`	Converts the `Decimal` to a `BigDecimal` value.
`byte`	`byteValue()`	Converts the `Decimal` to a `byte` value.
`int`	`compareTo(java.lang.Object other)`	Compares this `Decimal` object to another object.
`int`	`compareTo(Decimal other)`	Compares two `Decimal` objects numerically.
`byte[]`	`digits()`	Returns the actual decimal digits.
`double`	`doubleValue()`	Converts the `Decimal` to a `double` value.
`boolean`	`equals(java.lang.Object obj)`	Compares this object to another object.
`int`	`exponent()`	Returns the exponent of the `Decimal` value.
`float`	`floatValue()`	Converts the `Decimal` to a `float` value.
`int`	`intValue()`	Converts the `Decimal` to an `int` value.
`long`	`longValue()`	Converts the `Decimal` to a `long` value.
`Decimal`	`negate()`	Creates a newly allocated `Decimal` whose value is (-`this`).
`int`	`numDigits()`	Returns the number of significant digits in the `Decimal` value.
`short`	`shortValue()`	Converts the `Decimal` to a `short` value.
`int`	`sign()`	Returns the sign of the `Decimal` value.
`java.lang.String`	`toString()`	Converts the `Decimal` to a `String`.
`static java.lang.String`	`toString(Decimal dec)`	Converts the input `Decimal` to a `String`.
`static Decimal`	`valueOf(java.lang.String s)`	Constructs a newly allocated `Decimal` object from a `String` value.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - DECSIZE
```
public static final int DECSIZE
```
    Size of the array of bytes representing the digits of the Decimal.
    
    See Also:
    
    Constant Field Values
  - DECPOSNULL
```
public static final int DECPOSNULL
```
    Exponent value indicating a null Decimal, i.e., a Decimal with undefined value. Null Decimals cannot be compared numerically with other Decimals.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - exponent
```
public int exponent()
```
    Returns the exponent of the Decimal value. The exponent represents powers of 100.
    
    Returns:
    
    the exponent, from -64 to +63.
  - sign
```
public int sign()
```
    Returns the sign of the Decimal value.
    
    Returns:
    
    The sign of the value; 1 indicates a positive value, 0 a negative value and DECPOSNULL a null value.
    
    See Also:
    
    DECPOSNULL
  - numDigits
```
public int numDigits()
```
    Returns the number of significant digits in the Decimal value.
    
    Returns:
    
    the number of significant digits in the Decimal value.
  - digits
```
public byte[] digits()
```
    Returns the actual decimal digits. Each digit is in base-100.
    
    Returns:
    
    an array of bytes representing the actual decimal digits. The decimal point is to the left of the first digit.
  - negate
```
public Decimal negate()
```
    Creates a newly allocated Decimal whose value is (-this).
    
    Returns:
    
    a Decimal whose value is (-this). If the original Decimal has a null value, that is, its sign is DECPOSNULL, a new null Decimal is returned.
    
    See Also:
    
    DECPOSNULL
  - bigDecimalValue
```
public java.math.BigDecimal bigDecimalValue()
```
    Converts the Decimal to a BigDecimal value.
    
    Returns:
    
    the BigDecimal value representing the Decimal. If the Decimal has a null value, a new BigDecimal(Double.MIN_VALUE) is returned.
  - doubleValue
```
public double doubleValue()
```
    Converts the Decimal to a double value.
    
    Specified by:
    
    doubleValue in class java.lang.Number
    
    Returns:
    
    the double value representing the Decimal. If the Decimal has a null value, Double.MIN_VALUE is returned.
  - floatValue
```
public float floatValue()
                 throws java.lang.NumberFormatException
```
    Converts the Decimal to a float value.
    
    Specified by:
    
    floatValue in class java.lang.Number
    
    Returns:
    
    the float value representing the Decimal. If the Decimal has a null value, Float.MIN_VALUE is returned.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value would cause overflow when converted to a float.
  - longValue
```
public long longValue()
               throws java.lang.NumberFormatException
```
    Converts the Decimal to a long value.
    
    Specified by:
    
    longValue in class java.lang.Number
    
    Returns:
    
    the long value representing the Decimal. If the Decimal has a null value, Long.MIN_VALUE is returned.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value cannot be represented as a long.
  - intValue
```
public int intValue()
             throws java.lang.NumberFormatException
```
    Converts the Decimal to an int value.
    
    Specified by:
    
    intValue in class java.lang.Number
    
    Returns:
    
    the int value representing the Decimal. If the Decimal has a null value, Integer.MIN_VALUE is returned.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value cannot be represented as an int.
  - shortValue
```
public short shortValue()
                 throws java.lang.NumberFormatException
```
    Converts the Decimal to a short value.
    
    Overrides:
    
    shortValue in class java.lang.Number
    
    Returns:
    
    the short value representing the Decimal. If the Decimal has a null value, Short.MIN_VALUE is returned.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value cannot be represented as a short.
  - byteValue
```
public byte byteValue()
               throws java.lang.NumberFormatException
```
    Converts the Decimal to a byte value.
    
    Overrides:
    
    byteValue in class java.lang.Number
    
    Returns:
    
    the byte value representing the Decimal. If the Decimal has a null value, Byte.MIN_VALUE is returned.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value cannot be represented as a byte.
  - toString
```
public java.lang.String toString()
                          throws java.lang.NumberFormatException
```
    Converts the Decimal to a String. The String is in the format that the Java Double.toString method would generate for an equivalent double value.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    the String value representing the Decimal.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value cannot be represented as a double.
  - toString
```
public static java.lang.String toString(Decimal dec)
                                 throws java.lang.NumberFormatException
```
    Converts the input Decimal to a String. The String is in the format that the Java Double.toString method would generate for an equivalent double value.
    
    Parameters:
    
    dec - the Decimal object to convert.
    
    Returns:
    
    the String value representing the Decimal.
    
    Throws:
    
    java.lang.NumberFormatException - if the Decimal value cannot be represented as a double.
  - valueOf
```
public static Decimal valueOf(java.lang.String s)
                       throws java.lang.NumberFormatException
```
    Constructs a newly allocated Decimal object from a String value. The String is converted to a Decimal value. The String must be in the format accepted by the Java Double.parseDouble method.
    
    Parameters:
    
    s - the String value to convert.
    
    Returns:
    
    the Decimal value created
    
    Throws:
    
    java.lang.NumberFormatException - if the value is in the wrong format or would overflow or underflow when converted to Decimal.
  - compareTo
```
public int compareTo(java.lang.Object other)
              throws java.lang.NumberFormatException
```
    Compares this Decimal object to another object. If the other object is a Decimal, this function behaves like compareTo(Decimal). Otherwise, it throws a ClassCastException.
    
    Specified by:
    
    compareTo in interface java.lang.Comparable
    
    Parameters:
    
    other - the other object to compare
    
    Returns:
    
    the value 0 if the two objects are numerically equal; the value -1 if the current object is numerically less than the other; the value 1 if the current object is numerically greater than the other.
    
    Throws:
    
    java.lang.ClassCastException - if obj is not a Decimal
    
    java.lang.NumberFormatException - if either of the objects has a null value, that is, if their exponent is equal to DECPOSNULL.
    
    See Also:
    
    DECPOSNULL
  - compareTo
```
public int compareTo(Decimal other)
              throws java.lang.NumberFormatException
```
    Compares two Decimal objects numerically. Neither object can have a null value.
    
    Parameters:
    
    other - a Decimal that is compared against this object.
    
    Returns:
    
    the value 0 if the two objects are numerically equal; the value -1 if the current object is numerically less than other; the value 1 if the current object is numerically greater than other.
    
    Throws:
    
    java.lang.NumberFormatException - if either of the objects has a null value, that is, if their exponent is equal to DECPOSNULL.
    
    See Also:
    
    DECPOSNULL
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Compares this object to another object. The result is true if the other object is non-null and represents a Decimal object with the same value as the current object. The values are equal if the objects have identical bit patterns. Note that null valued Decimals may be compared in this operation (unlike compareTo(Decimal)).
    
    Overrides:
    
    equals in class java.lang.Object
    
    Parameters:
    
    obj - the other object to compare
    
    Returns:
    
    true if the other object is a Decimal with the same value as the current object.

Class Decimal

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DECSIZE

DECPOSNULL

Method Detail

exponent

sign

numDigits

digits

negate

bigDecimalValue

doubleValue

floatValue

longValue

intValue

shortValue

byteValue

toString

toString

valueOf

compareTo

compareTo

equals