|
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 longs with:
LongSummaryStatistics stats = longStream.collect(LongSummaryStatistics::new,
LongSummaryStatistics::accept,
LongSummaryStatistics::combine);
LongSummaryStatistics can be used as a reduction target for a stream. For example:
LongSummaryStatistics stats = people.stream()
.collect(Collectors.summarizingLong(Person::getAge));
This computes, in a single pass, the count of people, as well as the minimum,
maximum, sum, and average of their ages.This implementation does not check for overflow of the count or the sum.
Constructor Summary |
||
Constructs an empty instance with zero count, zero sum,
Long.MAX_VALUE min, Long.MIN_VALUE max and zero
average.
|
||
LongSummaryStatistics(long count, long min, long 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 int value into the summary information.
|
|
void |
accept(long value)
Records a new long value into the summary information.
|
|
void |
combine(LongSummaryStatistics other)
Combines the state of another LongSummaryStatistics 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 long |
getMax()
Returns the maximum value recorded, or Long.MIN_VALUE if no
values have been recorded
|
|
final long |
getMin()
Returns the minimum value recorded, or Long.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.LongConsumer |
Methods inherited from interface java.util.function.IntConsumer |
public LongSummaryStatistics |
() |
public LongSummaryStatistics |
(long count, long min, long 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 accept |
(long value) |
public void combine |
(LongSummaryStatistics other) |
public final long getCount |
() |
public final long getSum |
() |
public final long getMin |
() |
public final long getMax |
() |
public final double getAverage |
() |
public String toString |
() |
|
FlexDoc/Javadoc 2.0 Demo Java Doc |