src/share/classes/java/util/DoubleSummaryStatistics.java
Print this page
*** 109,124 ****
return count;
}
/**
* Returns the sum of values recorded, or zero if no values have been
! * recorded. The sum returned can vary depending upon the order in which
! * values are recorded. This is due to accumulated rounding error in
! * addition of values of differing magnitudes. Values sorted by increasing
! * absolute magnitude tend to yield more accurate results. If any recorded
! * value is a {@code NaN} or the sum is at any point a {@code NaN} then the
! * sum will be {@code NaN}.
*
* @return the sum of values, or zero if none
*/
public final double getSum() {
return sum;
--- 109,136 ----
return count;
}
/**
* Returns the sum of values recorded, or zero if no values have been
! * recorded.
! *
! * If any recorded value is a NaN or the sum is at any point a NaN
! * then the sum will be NaN.
! *
! * <p> The value of a floating-point sum is a function both of the
! * input values as well as the order of addition operations. The
! * order of addition operations of this method is intentionally
! * not defined to allow for implementation flexibility to improve
! * the speed and accuracy of the computed result.
! *
! * In particular, this method may be implemented using compensated
! * summation or other technique to reduce the error bound in the
! * numerical sum compared to a simple summation of {@code double}
! * values.
! *
! * @apiNote Sorting values by increasing absolute magnitude tends to yield
! * more accurate results.
*
* @return the sum of values, or zero if none
*/
public final double getSum() {
return sum;
*** 151,167 ****
public final double getMax() {
return max;
}
/**
! * Returns the arithmetic mean of values recorded, or zero if no values have been
! * recorded. The average returned can vary depending upon the order in
! * which values are recorded. This is due to accumulated rounding error in
! * addition of values of differing magnitudes. Values sorted by increasing
! * absolute magnitude tend to yield more accurate results. If any recorded
! * value is a {@code NaN} or the sum is at any point a {@code NaN} then the
! * average will be {@code NaN}.
*
* @return the arithmetic mean of values, or zero if none
*/
public final double getAverage() {
return getCount() > 0 ? getSum() / getCount() : 0.0d;
--- 163,187 ----
public final double getMax() {
return max;
}
/**
! * Returns the arithmetic mean of values recorded, or zero if no
! * values have been recorded.
! *
! * If any recorded value is a NaN or the sum is at any point a NaN
! * then the average will be code NaN.
! *
! * <p>The average returned can vary depending upon the order in
! * which values are recorded.
! *
! * This method may be implemented using compensated summation or
! * other technique to reduce the error bound in the {@link #getSum
! * numerical sum} used to compute the average.
! *
! * @apiNote Values sorted by increasing absolute magnitude tend to yield
! * more accurate results.
*
* @return the arithmetic mean of values, or zero if none
*/
public final double getAverage() {
return getCount() > 0 ? getSum() / getCount() : 0.0d;