Class IntSum
- All Implemented Interfaces:
DoubleSupplier
,IntConsumer
,IntSupplier
,LongSupplier
,IntStatistic
,StatisticAccumulator<IntSum>
,StatisticResult
- The result is zero if no values are added.
This class uses an exact integer sum. The exact sum is
returned using getAsBigInteger()
. Methods that return int
or
long
primitives will raise an exception if the result overflows.
The long
value is safe up to the maximum array length for any input
int[]
data. The long
value can overflow when instances are combined.
Note that the implementation does not use BigInteger
arithmetic; for
performance the sum is computed using primitives to create a signed 128-bit integer.
Support is provided for at least 263 observations.
This class is designed to work with (though does not require) streams.
This implementation is not thread safe.
If multiple threads access an instance of this class concurrently,
and at least one of the threads invokes the accept
or
combine
method, it must be synchronized externally.
However, it is safe to use accept
and combine
as accumulator
and combiner
functions of
Collector
on a parallel stream,
because the parallel implementation of Stream.collect()
provides the necessary partitioning, isolation, and merging of results for
safe and efficient parallel execution.
- Since:
- 1.1
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
accept
(int value) Updates the state of the statistic to reflect the addition ofvalue
.Combines the state of theother
statistic into this one.static IntSum
create()
Creates an instance.Gets the sum of all input values.double
Gets the sum of all input values.int
getAsInt()
Gets the sum of all input values.long
Gets the sum of all input values.(package private) Int128
getSum()
Gets the sum.static IntSum
of
(int... values) Returns an instance populated using the inputvalues
.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface java.util.function.IntConsumer
andThen
-
Field Details
-
sum
Sum of the values.
-
-
Constructor Details
-
IntSum
private IntSum()Create an instance. -
IntSum
Create an instance.- Parameters:
sum
- Sum of the values.
-
-
Method Details
-
create
Creates an instance.The initial result is zero.
- Returns:
IntSum
instance.
-
of
Returns an instance populated using the inputvalues
.When the input is an empty array, the result is zero.
The
getAsLong()
result is valid for any inputint[]
length; thegetAsInt()
result may overflow.- Parameters:
values
- Values.- Returns:
IntSum
instance.
-
getSum
Int128 getSum()Gets the sum.This is package private for use in
IntStatistics
.- Returns:
- the sum
-
accept
public void accept(int value) Updates the state of the statistic to reflect the addition ofvalue
.- Specified by:
accept
in interfaceIntConsumer
- Parameters:
value
- Value.
-
getAsInt
public int getAsInt()Gets the sum of all input values.When no values have been added, the result is zero.
Warning: This will raise an
ArithmeticException
if the result is not within the range[-2^31, 2^31)
.- Specified by:
getAsInt
in interfaceIntSupplier
- Specified by:
getAsInt
in interfaceStatisticResult
- Returns:
- sum of all values.
- Throws:
ArithmeticException
- if theresult
overflows anint
- See Also:
-
getAsLong
public long getAsLong()Gets the sum of all input values.When no values have been added, the result is zero.
Warning: This will raise an
ArithmeticException
if the result is not within the range[-2^63, 2^63)
.- Specified by:
getAsLong
in interfaceLongSupplier
- Specified by:
getAsLong
in interfaceStatisticResult
- Returns:
- sum of all values.
- Throws:
ArithmeticException
- if theresult
overflows along
- See Also:
-
getAsDouble
public double getAsDouble()Gets the sum of all input values.When no values have been added, the result is zero.
Note that this conversion can lose information about the precision of the
BigInteger
value.- Specified by:
getAsDouble
in interfaceDoubleSupplier
- Returns:
- sum of all values.
- See Also:
-
getAsBigInteger
Gets the sum of all input values.When no values have been added, the result is zero.
- Specified by:
getAsBigInteger
in interfaceStatisticResult
- Returns:
- sum of all values.
-
combine
Description copied from interface:StatisticAccumulator
Combines the state of theother
statistic into this one.- Specified by:
combine
in interfaceStatisticAccumulator<IntSum>
- Parameters:
other
- Another statistic to be combined.- Returns:
this
instance after combiningother
.
-