--- jsr166/src/extra166y/ParallelArrayWithLongMapping.java 2011/03/15 19:47:02 1.2 +++ jsr166/src/extra166y/ParallelArrayWithLongMapping.java 2015/01/18 20:17:32 1.6 @@ -5,6 +5,7 @@ */ package extra166y; + import jsr166y.*; import static extra166y.Ops.*; import java.util.*; @@ -24,7 +25,7 @@ public abstract class ParallelArrayWithL } /** - * Applies the given procedure + * Applies the given procedure. * @param procedure the procedure */ public void apply(LongProcedure procedure) { @@ -32,7 +33,7 @@ public abstract class ParallelArrayWithL } /** - * Returns reduction of mapped elements + * Returns reduction of mapped elements. * @param reducer the reducer * @param base the result for an empty array * @return reduction @@ -45,7 +46,7 @@ public abstract class ParallelArrayWithL } /** - * Returns the minimum element, or Long.MAX_VALUE if empty + * Returns the minimum element, or Long.MAX_VALUE if empty. * @return minimum element, or Long.MAX_VALUE if empty */ public long min() { @@ -53,7 +54,7 @@ public abstract class ParallelArrayWithL } /** - * Returns the minimum element, or Long.MAX_VALUE if empty + * Returns the minimum element, or Long.MAX_VALUE if empty. * @param comparator the comparator * @return minimum element, or Long.MAX_VALUE if empty */ @@ -62,7 +63,7 @@ public abstract class ParallelArrayWithL } /** - * Returns the maximum element, or Long.MIN_VALUE if empty + * Returns the maximum element, or Long.MIN_VALUE if empty. * @return maximum element, or Long.MIN_VALUE if empty */ public long max() { @@ -70,7 +71,7 @@ public abstract class ParallelArrayWithL } /** - * Returns the maximum element, or Long.MIN_VALUE if empty + * Returns the maximum element, or Long.MIN_VALUE if empty. * @param comparator the comparator * @return maximum element, or Long.MIN_VALUE if empty */ @@ -79,7 +80,7 @@ public abstract class ParallelArrayWithL } /** - * Returns the sum of elements + * Returns the sum of elements. * @return the sum of elements */ public long sum() { @@ -87,10 +88,10 @@ public abstract class ParallelArrayWithL } /** - * Returns summary statistics + * Returns summary statistics. * @param comparator the comparator to use for * locating minimum and maximum elements - * @return the summary. + * @return the summary */ public ParallelLongArray.SummaryStatistics summary (LongComparator comparator) { @@ -101,15 +102,15 @@ public abstract class ParallelArrayWithL } /** - * Returns summary statistics, using natural comparator - * @return the summary. + * Returns summary statistics, using natural comparator. + * @return the summary */ public ParallelLongArray.SummaryStatistics summary() { return summary(CommonOps.naturalLongComparator()); } /** - * Returns a new ParallelLongArray holding mappings + * Returns a new ParallelLongArray holding mappings. * @return a new ParallelLongArray holding mappings */ public ParallelLongArray all() { @@ -138,7 +139,7 @@ public abstract class ParallelArrayWithL * @param op the op * @return operation prefix */ - public abstract ParallelArrayWithMapping withMapping + public abstract ParallelArrayWithMapping withMapping (LongToObject op); /** @@ -148,7 +149,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithMapping withMapping (LongAndObjectToObject combiner, @@ -165,7 +166,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithMapping withMapping (LongAndDoubleToObject combiner, @@ -182,7 +183,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithMapping withMapping (LongAndLongToObject combiner, @@ -199,7 +200,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithDoubleMapping withMapping (LongAndObjectToDouble combiner, @@ -216,7 +217,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithDoubleMapping withMapping (LongAndDoubleToDouble combiner, @@ -234,7 +235,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithDoubleMapping withMapping (LongAndLongToDouble combiner, @@ -251,7 +252,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithLongMapping withMapping (LongAndObjectToLong combiner, @@ -269,7 +270,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithLongMapping withMapping (LongAndDoubleToLong combiner, @@ -287,7 +288,7 @@ public abstract class ParallelArrayWithL * @param other the other array * @return operation prefix * @throws IllegalArgumentException if other array is a - * filtered view (all filters must precede all mappings). + * filtered view (all filters must precede all mappings) */ public ParallelArrayWithLongMapping withMapping (BinaryLongOp combiner, @@ -336,11 +337,10 @@ public abstract class ParallelArrayWithL /** * Returns an Iterable view to sequentially step through mapped * elements also obeying bound and filter constraints, without - * performing computations to evaluate them in parallel + * performing computations to evaluate them in parallel. * @return the Iterable view */ public Iterable sequentially() { return new SequentiallyAsLong(); } } -