|
FlexDoc/Javadoc 2.0 Demo Java Doc |
This class is designed to work with (though does not require) streams. For example, you can compute summary statistics on a stream of ints with:
IntSummaryStatistics stats = intStream.collect(IntSummaryStatistics::new,
IntSummaryStatistics::accept,
IntSummaryStatistics::combine);
IntSummaryStatistics can be used as a reduction target for a stream. For example:
IntSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingInt(Person::getDependents));
This computes, in a single pass, the count of people, as well as the minimum,
maximum, sum, and average of their number of dependents.This implementation does not check for overflow of the count or the sum.
Constructor Summary |
||
Constructs an empty instance with zero count, zero sum,
Integer.MAX_VALUE min, Integer.MIN_VALUE max and zero
average.
|
||
IntSummaryStatistics(long count, int min, int max, long sum)
Constructs a non-empty instance with the specified count,
min, max, and sum.
|
Method Summary |
||
void |
accept(int value)
Records a new value into the summary information
|
|
void |
combine(IntSummaryStatistics other)
Combines the state of another IntSummaryStatistics into this one.
|
|
final double |
Returns the arithmetic mean of values recorded, or zero if no values have been
recorded.
|
|
final long |
getCount()
Returns the count of values recorded.
|
|
final int |
getMax()
Returns the maximum value recorded, or Integer.MIN_VALUE if no
values have been recorded.
|
|
final int |
getMin()
Returns the minimum value recorded, or Integer.MAX_VALUE if no
values have been recorded.
|
|
final long |
getSum()
Returns the sum of values recorded, or zero if no values have been
recorded.
|
|
toString()
Returns a non-empty string representation of this object suitable for
debugging.
|
Methods inherited from class java.lang.Object |
Methods inherited from interface java.util.function.IntConsumer |
public IntSummaryStatistics |
() |
public IntSummaryStatistics |
(long count, int min, int max, long sum) |
throws |
If count is zero then the remaining arguments are ignored and an empty instance is constructed.
If the arguments are inconsistent then an IllegalArgumentException is thrown. The necessary consistent argument conditions are:
public void accept |
(int value) |
public void combine |
(IntSummaryStatistics other) |
public final long getCount |
() |
public final long getSum |
() |
public final int getMin |
() |
public final int getMax |
() |
public final double getAverage |
() |
public String toString |
() |
|
FlexDoc/Javadoc 2.0 Demo Java Doc |