src/share/classes/java/util/DoubleSummaryStatistics.java

rev 7597 : 8015318: Extend Collector with 'finish' operation
Reviewed-by:
Contributed-by: brian.goetz@oracle.com

*** 43,60 ****
   * {@linkplain java.util.stream.Stream#reduce(java.util.function.BinaryOperator) reduction}
   * target for a {@linkplain java.util.stream.Stream stream}. For example:
   *
   * <pre> {@code
   * DoubleSummaryStatistics stats = people.stream()
!  *     .collect(Collectors.toDoubleSummaryStatistics(Person::getWeight));
   *}</pre>
   *
   * This computes, in a single pass, the count of people, as well as the minimum,
   * maximum, sum, and average of their weights.
   *
   * @implNote This implementation is not thread safe. However, it is safe to use
!  * {@link java.util.stream.Collectors#toDoubleSummaryStatistics(java.util.function.ToDoubleFunction)
   * Collectors.toDoubleStatistics()} on a parallel stream, because the parallel
   * implementation of {@link java.util.stream.Stream#collect Stream.collect()}
   * provides the necessary partitioning, isolation, and merging of results for
   * safe and efficient parallel execution.
   * @since 1.8
--- 43,60 ----
   * {@linkplain java.util.stream.Stream#reduce(java.util.function.BinaryOperator) reduction}
   * target for a {@linkplain java.util.stream.Stream stream}. For example:
   *
   * <pre> {@code
   * DoubleSummaryStatistics stats = people.stream()
!  *     .collect(Collectors.summarizingDouble(Person::getWeight));
   *}</pre>
   *
   * This computes, in a single pass, the count of people, as well as the minimum,
   * maximum, sum, and average of their weights.
   *
   * @implNote This implementation is not thread safe. However, it is safe to use
!  * {@link java.util.stream.Collectors#summarizingDouble(java.util.function.ToDoubleFunction)
   * Collectors.toDoubleStatistics()} on a parallel stream, because the parallel
   * implementation of {@link java.util.stream.Stream#collect Stream.collect()}
   * provides the necessary partitioning, isolation, and merging of results for
   * safe and efficient parallel execution.
   * @since 1.8