@Immutable public class LongOperations extends Object implements MathOperations<Long>, Comparator<Long>
math operations
for long numbers.Constructor and Description |
---|
LongOperations() |
Modifier and Type | Method and Description |
---|---|
Long |
add(Long value1,
Long value2)
Add the two operands and return the sum.
|
BigDecimal |
asBigDecimal(Long value)
Create a
BigDecimal representation of the supplied value. |
int |
compare(Long value1,
Long value2)
Compare the two operands and return an integer that describes whether the first value is larger, smaller or the same as the
second value.
|
Long |
create(double value)
Convert the double representation into the natural object representation.
|
Long |
create(int value)
Convert the integer representation into the natural object representation.
|
Long |
create(long value)
Convert the long representation into the natural object representation.
|
Long |
createZeroValue()
Create the object form of the "zero value".
|
double |
divide(Long value1,
Long value2)
Divide the first operand by the second, and return the result.
|
double |
doubleValue(Long value)
Convert the value to a double.
|
float |
floatValue(Long value)
Convert the value to a float.
|
Long |
fromBigDecimal(BigDecimal value)
Convert the
BigDecimal representation into the natural object representation. |
Comparator<Long> |
getComparator()
Return a
Comparator for this operand class . |
int |
getExponentInScientificNotation(Long value)
Get the exponent if the number were written in exponential form.
|
Class<Long> |
getOperandClass()
Return the class that these operations operate upon.
|
Long |
increment(Long value)
Increment the supplied operand by 1.
|
int |
intValue(Long value)
Convert the value to an integer.
|
Long |
keepSignificantFigures(Long value,
int numSigFigs) |
long |
longValue(Long value)
Convert the value to a long integer.
|
Long |
maximum(Long value1,
Long value2)
Compare the two operands and return the one that is larger.
|
Long |
minimum(Long value1,
Long value2)
Compare the two operands and return the one that is smaller.
|
Long |
multiply(Long value1,
Long value2)
Multiply the two operands and return the product.
|
Long |
negate(Long value)
Negate the supplied operand.
|
Long |
random(Long minimum,
Long maximum,
Random rng)
Generate a random instance within the specified range.
|
Long |
roundDown(Long value,
int decimalShift)
Round down the supplied value to the desired scale.
|
Long |
roundUp(Long value,
int decimalShift)
Round up the supplied value to the desired scale.
|
short |
shortValue(Long value)
Convert the value to a short.
|
double |
sqrt(Long value)
Return the square root of the supplied operand.
|
Long |
subtract(Long value1,
Long value2)
Subtract the second operand from the first, and return the difference.
|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
comparing, comparing, comparingDouble, comparingInt, comparingLong, equals, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong
public Class<Long> getOperandClass()
MathOperations
getOperandClass
in interface MathOperations<Long>
public Long add(Long value1, Long value2)
MathOperations
zero value
is used in place of any operand that is
null.add
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic Long subtract(Long value1, Long value2)
MathOperations
zero value
is used in
place of any operand that is null.subtract
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic Long multiply(Long value1, Long value2)
MathOperations
zero value
is used in place of any operand
that is null.multiply
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic double divide(Long value1, Long value2)
MathOperations
zero value
is used in place
of any operand that is null.divide
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic Long negate(Long value)
MathOperations
zero value
is used in place of any operand that is null.negate
in interface MathOperations<Long>
value
- the value that is to be negatedpublic Long increment(Long value)
MathOperations
operand class
. The zero value
is used in place of any operand that is
null.increment
in interface MathOperations<Long>
value
- the value that is to be incrementedpublic Long maximum(Long value1, Long value2)
MathOperations
maximum
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic Long minimum(Long value1, Long value2)
MathOperations
minimum
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic int compare(Long value1, Long value2)
MathOperations
Comparable
. The zero value
is used
in place of any operand that is null.compare
in interface Comparator<Long>
compare
in interface MathOperations<Long>
value1
- the first operandvalue2
- the second operandpublic BigDecimal asBigDecimal(Long value)
MathOperations
BigDecimal
representation of the supplied value.asBigDecimal
in interface MathOperations<Long>
value
- the value that is to be converted to a BigDecimalvalue
is nullpublic Long fromBigDecimal(BigDecimal value)
MathOperations
BigDecimal
representation into the natural object representation. This may result in loss of some data
(e.g., converting a decimal to an integer results in the loss of the fractional part of the number).fromBigDecimal
in interface MathOperations<Long>
value
- the BigDecimal valuevalue
is nullpublic Long createZeroValue()
MathOperations
createZeroValue
in interface MathOperations<Long>
public Long create(int value)
MathOperations
create
in interface MathOperations<Long>
value
- the integer valuepublic Long create(long value)
MathOperations
create
in interface MathOperations<Long>
value
- the long valuepublic Long create(double value)
MathOperations
create
in interface MathOperations<Long>
value
- the double valuepublic double sqrt(Long value)
MathOperations
sqrt
in interface MathOperations<Long>
value
- the value whose root is to be found; may not be null or 0public Comparator<Long> getComparator()
MathOperations
Comparator
for this operand class
. The implementation is free to
return the same comparator instance from multiple invocations of this method.getComparator
in interface MathOperations<Long>
public Long random(Long minimum, Long maximum, Random rng)
MathOperations
random
in interface MathOperations<Long>
minimum
- the minimum value, or null if the zero-value
should be used for the minimummaximum
- the maximum value, or null if the zero-value
should be used for the maximumrng
- the random number generator to useoperand class
placed within the desired range using a random
distribution, or null if this class does not support generating random instancespublic double doubleValue(Long value)
MathOperations
operand class
.doubleValue
in interface MathOperations<Long>
value
- the valuepublic float floatValue(Long value)
MathOperations
operand
class
.floatValue
in interface MathOperations<Long>
value
- the valuepublic int intValue(Long value)
MathOperations
operand class
.intValue
in interface MathOperations<Long>
value
- the valuepublic long longValue(Long value)
MathOperations
operand class
.longValue
in interface MathOperations<Long>
value
- the valuepublic short shortValue(Long value)
MathOperations
operand
class
.shortValue
in interface MathOperations<Long>
value
- the valuepublic int getExponentInScientificNotation(Long value)
MathOperations
getExponentInScientificNotation
in interface MathOperations<Long>
value
- the valuepublic Long roundUp(Long value, int decimalShift)
MathOperations
decimalShift
places, rounding, and then shifting the decimal point of the rounded value by
-decimalShift
For example, consider the number 10.000354. This can be rounded to 10.0004 by calling this method and supplying the value and an "exponentToKeep" value of -4.
roundUp
in interface MathOperations<Long>
value
- the value to be roundeddecimalShift
- the number of places the decimal point should be shifted before roundingpublic Long roundDown(Long value, int decimalShift)
MathOperations
decimalShift
places, rounding, and then shifting the decimal point of the rounded value by
-decimalShift
For example, consider the number 10.000354. This can be rounded to 10.0003 by calling this method and supplying the value and an "exponentToKeep" value of -4.
roundDown
in interface MathOperations<Long>
value
- the value to be roundeddecimalShift
- the number of places the decimal point should be shifted before roundingpublic Long keepSignificantFigures(Long value, int numSigFigs)
keepSignificantFigures
in interface MathOperations<Long>
Copyright © 2008–2016 JBoss, a division of Red Hat. All rights reserved.