--- jsr166/src/extra166y/ParallelLongArrayWithMapping.java 2012/07/04 20:13:53 1.4 +++ jsr166/src/extra166y/ParallelLongArrayWithMapping.java 2012/12/29 23:55:19 1.5 @@ -24,7 +24,7 @@ public abstract class ParallelLongArrayW } /** - * Applies the given procedure to mapped elements + * Applies the given procedure to mapped elements. * @param procedure the procedure */ public void apply(Procedure procedure) { @@ -32,7 +32,7 @@ public abstract class ParallelLongArrayW } /** - * Returns reduction of mapped elements + * Returns reduction of mapped elements. * @param reducer the reducer * @param base the result for an empty array * @return reduction @@ -47,7 +47,7 @@ public abstract class ParallelLongArrayW /** * Returns mapping of some element matching bound and filter * constraints, or null if none. - * @return mapping of matching element, or null if none. + * @return mapping of matching element, or null if none */ public U any() { int i = anyIndex(); @@ -55,7 +55,7 @@ public abstract class ParallelLongArrayW } /** - * Returns the minimum mapped element, or null if empty + * Returns the minimum mapped element, or null if empty. * @param comparator the comparator * @return minimum mapped element, or null if empty */ @@ -65,16 +65,16 @@ public abstract class ParallelLongArrayW /** * Returns the minimum mapped element, or null if empty, - * assuming that all elements are Comparables + * assuming that all elements are Comparables. * @return minimum mapped element, or null if empty - * @throws ClassCastException if any element is not Comparable. + * @throws ClassCastException if any element is not Comparable */ public U min() { return reduce((Reducer)(CommonOps.castedMinReducer()), null); } /** - * Returns the maximum mapped element, or null if empty + * Returns the maximum mapped element, or null if empty. * @param comparator the comparator * @return maximum mapped element, or null if empty */ @@ -83,10 +83,10 @@ public abstract class ParallelLongArrayW } /** - * Returns the maximum mapped element, or null if empty - * assuming that all elements are Comparables + * Returns the maximum mapped element, or null if empty, + * assuming that all elements are Comparables. * @return maximum mapped element, or null if empty - * @throws ClassCastException if any element is not Comparable. + * @throws ClassCastException if any element is not Comparable */ public U max() { return reduce((Reducer)(CommonOps.castedMaxReducer()), null); @@ -97,7 +97,7 @@ public abstract class ParallelLongArrayW * to locate minimum and maximum elements. * @param comparator the comparator to use for * locating minimum and maximum elements - * @return the summary. + * @return the summary */ public ParallelArray.SummaryStatistics summary (Comparator comparator) { @@ -109,15 +109,15 @@ public abstract class ParallelLongArrayW /** * Returns summary statistics, assuming that all elements are - * Comparables - * @return the summary. + * Comparables. + * @return the summary */ public ParallelArray.SummaryStatistics summary() { return summary((Comparator)(CommonOps.castedComparator())); } /** - * Returns a new ParallelArray holding mapped elements + * Returns a new ParallelArray holding mapped elements. * @return a new ParallelArray holding mapped elements */ public ParallelArray all() { @@ -126,7 +126,7 @@ public abstract class ParallelLongArrayW /** * Returns a new ParallelArray with the given element type holding - * all elements + * all elements. * @param elementType the type of the elements * @return a new ParallelArray holding all elements */ @@ -137,7 +137,7 @@ public abstract class ParallelLongArrayW /** * Returns an operation prefix that causes a method to operate * on mapped elements of the array using the given op - * applied to current op's results + * applied to current op's results. * @param op the op * @return operation prefix */ @@ -147,7 +147,7 @@ public abstract class ParallelLongArrayW /** * Returns an operation prefix that causes a method to operate * on mapped elements of the array using the given op - * applied to current op's results + * applied to current op's results. * @param op the op * @return operation prefix */ @@ -157,7 +157,7 @@ public abstract class ParallelLongArrayW /** * Returns an operation prefix that causes a method to operate * on mapped elements of the array using the given op - * applied to current op's results + * applied to current op's results. * @param op the op * @return operation prefix */ @@ -171,7 +171,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithMapping withMapping (BinaryOp combiner, @@ -188,7 +188,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithMapping withMapping (ObjectAndDoubleToObject combiner, @@ -204,7 +204,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithMapping withMapping (ObjectAndLongToObject combiner, @@ -221,7 +221,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithDoubleMapping withMapping (ObjectAndObjectToDouble combiner, @@ -238,7 +238,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithDoubleMapping withMapping (ObjectAndDoubleToDouble combiner, @@ -255,7 +255,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithDoubleMapping withMapping (ObjectAndLongToDouble combiner, @@ -272,7 +272,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithLongMapping withMapping (ObjectAndObjectToLong combiner, @@ -289,7 +289,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithLongMapping withMapping (ObjectAndDoubleToLong combiner, @@ -306,7 +306,7 @@ public abstract class ParallelLongArrayW * @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 ParallelLongArrayWithLongMapping withMapping (ObjectAndLongToLong combiner, @@ -355,7 +355,7 @@ public abstract class ParallelLongArrayW /** * 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() {