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.
! *
! * @apiNote 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.
! *
! * 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.
! *
! * @apiNote 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 numerical sum
! * used to compute the average.
! *
! * 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;