Decimal (Paimon : 1.0-SNAPSHOT API)

java.lang.Object
- org.apache.paimon.data.Decimal

All Implemented Interfaces:

Serializable, Comparable<Decimal>
```
@Public
public final class Decimal
extends Object
implements Comparable<Decimal>, Serializable
```
An internal data structure representing data of DecimalType.
This data structure is immutable and might store decimal values in a compact representation (as a long value) if values are small enough.

Since:

0.4.0

See Also:

Serialized Form

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`int`	`compareTo(Decimal that)`
`Decimal`	`copy()` Returns a copy of this `Decimal` object.
`boolean`	`equals(Object o)`
`static Decimal`	`fromBigDecimal(BigDecimal bd, int precision, int scale)` Creates an instance of `Decimal` from a `BigDecimal` and the given precision and scale.
`static Decimal`	`fromUnscaledBytes(byte[] unscaledBytes, int precision, int scale)` Creates an instance of `Decimal` from an unscaled byte array value and the given precision and scale.
`static Decimal`	`fromUnscaledLong(long unscaledLong, int precision, int scale)` Creates an instance of `Decimal` from an unscaled long value and the given precision and scale.
`int`	`hashCode()`
`boolean`	`isCompact()` Returns whether the decimal value is small enough to be stored in a long.
`static boolean`	`isCompact(int precision)` Returns whether the decimal value is small enough to be stored in a long.
`int`	`precision()` Returns the precision of this `Decimal`.
`int`	`scale()` Returns the scale of this `Decimal`.
`BigDecimal`	`toBigDecimal()` Converts this `Decimal` into an instance of `BigDecimal`.
`String`	`toString()`
`byte[]`	`toUnscaledBytes()` Returns a byte array describing the unscaled value of this `Decimal`.
`long`	`toUnscaledLong()` Returns a long describing the unscaled value of this `Decimal`.
`static Decimal`	`zero(int precision, int scale)` Creates an instance of `Decimal` for a zero value with the given precision and scale.

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

- Method Detail
  - precision
```
public int precision()
```
    Returns the precision of this Decimal.
    The precision is the number of digits in the unscaled value.
  - scale
```
public int scale()
```
    Returns the scale of this Decimal.
  - toBigDecimal
```
public BigDecimal toBigDecimal()
```
    Converts this Decimal into an instance of BigDecimal.
  - toUnscaledLong
```
public long toUnscaledLong()
```
    Returns a long describing the unscaled value of this Decimal.
    
    Throws:
    
    ArithmeticException - if this Decimal does not exactly fit in a long.
  - toUnscaledBytes
```
public byte[] toUnscaledBytes()
```
    Returns a byte array describing the unscaled value of this Decimal.
    
    Returns:
    
    the unscaled byte array of this Decimal.
  - isCompact
```
public boolean isCompact()
```
    Returns whether the decimal value is small enough to be stored in a long.
  - copy
```
public Decimal copy()
```
    Returns a copy of this Decimal object.
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - compareTo
```
public int compareTo(@Nonnull
                     Decimal that)
```
    Specified by:
    
    compareTo in interface Comparable<Decimal>
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - fromBigDecimal
```
@Nullable
public static Decimal fromBigDecimal(BigDecimal bd,
                                               int precision,
                                               int scale)
```
    Creates an instance of Decimal from a BigDecimal and the given precision and scale.
    The returned decimal value may be rounded to have the desired scale. The precision will be checked. If the precision overflows, null will be returned.
  - fromUnscaledLong
```
public static Decimal fromUnscaledLong(long unscaledLong,
                                       int precision,
                                       int scale)
```
    Creates an instance of Decimal from an unscaled long value and the given precision and scale.
  - fromUnscaledBytes
```
public static Decimal fromUnscaledBytes(byte[] unscaledBytes,
                                        int precision,
                                        int scale)
```
    Creates an instance of Decimal from an unscaled byte array value and the given precision and scale.
  - zero
```
@Nullable
public static Decimal zero(int precision,
                                     int scale)
```
    Creates an instance of Decimal for a zero value with the given precision and scale.
    The precision will be checked. If the precision overflows, null will be returned.
  - isCompact
```
public static boolean isCompact(int precision)
```
    Returns whether the decimal value is small enough to be stored in a long.

Back to Paimon Website

Class Decimal

Method Summary

Methods inherited from class java.lang.Object

Method Detail

precision

scale

toBigDecimal

toUnscaledLong

toUnscaledBytes

isCompact

copy

hashCode

compareTo

equals

toString

fromBigDecimal

fromUnscaledLong

fromUnscaledBytes

zero

isCompact

Back to Paimon Website