Class IntMax
- java.lang.Object
-
- org.apache.commons.statistics.descriptive.IntMax
-
- All Implemented Interfaces:
DoubleSupplier
,IntConsumer
,IntSupplier
,LongSupplier
,IntStatistic
,StatisticAccumulator<IntMax>
,StatisticResult
public final class IntMax extends Object implements IntStatistic, StatisticAccumulator<IntMax>
Returns the maximum of the available values. UsesMath.max
as an underlying function to compute themaximum
.- The result is
Integer.MIN_VALUE
if no values are added.
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
orcombine
method, it must be synchronized externally.However, it is safe to use
accept
andcombine
asaccumulator
andcombiner
functions ofCollector
on a parallel stream, because the parallel implementation ofStream.collect()
provides the necessary partitioning, isolation, and merging of results for safe and efficient parallel execution.- Since:
- 1.1
- See Also:
Math.max(int, int)
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
accept(int value)
Updates the state of the statistic to reflect the addition ofvalue
.IntMax
combine(IntMax other)
Combines the state of theother
statistic into this one.static IntMax
create()
Creates an instance.BigInteger
getAsBigInteger()
Gets a result as aBigInteger
.double
getAsDouble()
int
getAsInt()
Gets the maximum of all input values.long
getAsLong()
static IntMax
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
-
-
-
-
Method Detail
-
create
public static IntMax create()
Creates an instance.The initial result is
Integer.MIN_VALUE
.- Returns:
Max
instance.
-
of
public static IntMax of(int... values)
Returns an instance populated using the inputvalues
.When the input is an empty array, the result is
Integer.MIN_VALUE
.- Parameters:
values
- Values.- Returns:
Max
instance.
-
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 maximum of all input values.When no values have been added, the result is
Integer.MIN_VALUE
.- Specified by:
getAsInt
in interfaceIntSupplier
- Specified by:
getAsInt
in interfaceStatisticResult
- Returns:
- maximum of all values.
-
getAsLong
public long getAsLong()
Description copied from interface:StatisticResult
The default implementation uses the closest representable
long
value of theDoubleSupplier.getAsDouble()
result
. In the event of ties the result is rounded towards positive infinity. This will raise anArithmeticException
if the closest integer result is not within the range[-2^63, 2^63)
.- Specified by:
getAsLong
in interfaceLongSupplier
- Specified by:
getAsLong
in interfaceStatisticResult
-
getAsDouble
public double getAsDouble()
- Specified by:
getAsDouble
in interfaceDoubleSupplier
-
getAsBigInteger
public BigInteger getAsBigInteger()
Description copied from interface:StatisticResult
Gets a result as aBigInteger
.The default implementation uses the closest representable
BigInteger
value of theDoubleSupplier.getAsDouble()
result
. In the event of ties the result is rounded towards positive infinity. This will raise anArithmeticException
if theresult
is not finite.- Specified by:
getAsBigInteger
in interfaceStatisticResult
- Returns:
- a result
-
combine
public IntMax combine(IntMax other)
Description copied from interface:StatisticAccumulator
Combines the state of theother
statistic into this one.- Specified by:
combine
in interfaceStatisticAccumulator<IntMax>
- Parameters:
other
- Another statistic to be combined.- Returns:
this
instance after combiningother
.
-
-