- Author:
- Mark Rotteveel
-
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionstatic Decimal32parseBytes(byte[] decBytes) Parses the provided byte array to aDecimal32.static Decimal32valueOf(double value) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32valueOf(double value, OverflowHandling overflowHandling) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32valueOf(String value, OverflowHandling overflowHandling) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32valueOf(BigDecimal value) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32valueOf(BigDecimal value, OverflowHandling overflowHandling) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32valueOf(BigInteger value) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32valueOf(BigInteger value, OverflowHandling overflowHandling) Creates aDecimal32fromvalue, applying rounding where necessary.static Decimal32Converts a decimal to Decimal32.static Decimal32valueOf(Decimal<?> decimal, OverflowHandling overflowHandling) Converts a decimal to Decimal32.static Decimal32valueOfExact(BigInteger value) Creates aDecimal32fromvalue, rejecting values that would lose precision due to rounding.Methods inherited from class org.firebirdsql.extern.decimal.Decimal
doubleValue, equals, hashCode, toBigDecimal, toBytes, toDecimal, toDecimal, toString
-
Field Details
-
POSITIVE_INFINITY
-
NEGATIVE_INFINITY
-
POSITIVE_NAN
-
NEGATIVE_NAN
-
POSITIVE_SIGNALING_NAN
-
NEGATIVE_SIGNALING_NAN
-
-
Method Details
-
parseBytes
Parses the provided byte array to aDecimal32.This method parses network byte-order (aka big-endian). When using little-endian order, you will need to reverse the bytes in the array first.
- Parameters:
decBytes- Bytes of the Decimal32 value in network byte-order (aka big-endian)- Returns:
- Instance of
Decimal32 - Throws:
IllegalArgumentException- WhendecBytesis not 4 bytes long
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Values exceeding the range of this type will be returned as +/-Infinity.
- Parameters:
value- Big decimal value to convert- Returns:
- Decimal32 equivalent
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Values exceeding the range of this type will be handled according to the specified overflow handling.
- Parameters:
value- Big decimal value to convertoverflowHandling- Overflow handling to apply- Returns:
- Decimal32 equivalent
- Throws:
DecimalOverflowException- IfOverflowHandling#THROW_EXCEPTIONand the value is out of range.
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Values exceeding the range of this type will be returned as +/-Infinity.
- Parameters:
value- Big integer value to convert- Returns:
- Decimal32 equivalent
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Values exceeding the range of this type will be handled according to the specified overflow handling.
Calling this method is equivalent to
valueOf(new BigDecimal(value), overflowHandling).- Parameters:
value- Big integer value to convertoverflowHandling- Handling of overflows- Returns:
- Decimal32 equivalent
- Throws:
DecimalOverflowException- IfOverflowHandling#THROW_EXCEPTIONand the value is out of range.- See Also:
-
valueOfExact
Creates aDecimal32fromvalue, rejecting values that would lose precision due to rounding.- Parameters:
value- Big integer value to convert- Returns:
- Decimal32 equivalent
- Throws:
DecimalOverflowException- If the value is out of range.- See Also:
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Double.NaNis mapped to positive NaN, the infinities to their equivalent +/- infinity.For normal, finite, values, this is equivalent to
valueOf(BigDecimal.valueOf(value)).- Parameters:
value- Double value- Returns:
- Decimal equivalent
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Double.NaNis mapped to positive NaN, the infinities to their equivalent +/- infinity.For normal, finite, values, this is equivalent to
valueOf(BigDecimal.valueOf(value), overflowHandling).- Parameters:
value- Double valueoverflowHandling- Overflow handling to apply- Returns:
- Decimal equivalent
- Throws:
DecimalOverflowException- IfOverflowHandling#THROW_EXCEPTIONand the value is out of range.
-
valueOf
Converts a decimal to Decimal32.For normal, finite, decimals, this behaves like
valueOf(decimal.toBigDecimal()), seevalueOf(BigDecimal).- Parameters:
decimal- Decimal to convert- Returns:
- Decimal converted to Decimal32, or
decimalitself if it already is Decimal32
-
valueOf
Converts a decimal to Decimal32.For normal, finite, decimals, this behaves like
valueOf(decimal.toBigDecimal(), overflowHandling), seevalueOf(BigDecimal, OverflowHandling).- Parameters:
decimal- Decimal to convertoverflowHandling- Overflow handling to apply- Returns:
- Decimal converted to Decimal32, or
decimalitself if it already is Decimal32 - Throws:
DecimalOverflowException- IfOverflowHandling#THROW_EXCEPTIONand the value is out of range.
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Except for the special values [+/-]Inf, [+/-]Infinity, [+/-]NaN and [+/-]sNaN (case insensitive), the rules of
BigDecimal(String)apply, with special handling in place to discern between positive and negative zero.Values exceeding the range of this type will be returned as +/-Infinity.
- Parameters:
value- String value to convert- Returns:
- Decimal equivalent
- Throws:
NumberFormatException- If the provided string is not valid numeric string.
-
valueOf
Creates aDecimal32fromvalue, applying rounding where necessary.Except for the special values [+/-]Inf, [+/-]Infinity, [+/-]NaN and [+/-]sNaN (case insensitive), the rules of
BigDecimal(String)apply, with special handling in place to discern between positive and negative zero.Values exceeding the range of this type will be handled according to the specified overflow handling.
- Parameters:
value- String value to convertoverflowHandling- Overflow handling to apply- Returns:
- Decimal equivalent
- Throws:
NumberFormatException- If the provided string is not valid numeric string.DecimalOverflowException- IfOverflowHandling#THROW_EXCEPTIONand the value is out of range.
-