jdk-sandbox: comparison jdk/src/java.base/share/classes/java/util/Arrays.java

equal deleted inserted replaced

-:be92cc7636f8
+:a9f00e8ae58b
 * generator function to compute each element.
 *
 * <p>If the generator function throws an exception, it is relayed to
 * the caller and the array is left in an indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, using a generator function to compute
+* each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .forEach(i -> array[i] = generator.apply(i));
+* }</pre>
+*
 * @param <T> type of elements of the array
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null
 *
 * <p>If the generator function throws an exception, an unchecked exception
 * is thrown from {@code parallelSetAll} and the array is left in an
 * indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, in parallel, using a generator function
+* to compute each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .parallel()
+*          .forEach(i -> array[i] = generator.apply(i));
+* }</pre>
+*
 * @param <T> type of elements of the array
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null
 * generator function to compute each element.
 *
 * <p>If the generator function throws an exception, it is relayed to
 * the caller and the array is left in an indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, using a generator function to compute
+* each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .forEach(i -> array[i] = generator.applyAsInt(i));
+* }</pre>
+*
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null
 * @since 1.8
 *
 * <p>If the generator function throws an exception, an unchecked exception
 * is thrown from {@code parallelSetAll} and the array is left in an
 * indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, in parallel, using a generator function
+* to compute each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .parallel()
+*          .forEach(i -> array[i] = generator.applyAsInt(i));
+* }</pre>
+*
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 * value for that position
 * @throws NullPointerException if the generator is null
 * @since 1.8
 * generator function to compute each element.
 *
 * <p>If the generator function throws an exception, it is relayed to
 * the caller and the array is left in an indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, using a generator function to compute
+* each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .forEach(i -> array[i] = generator.applyAsLong(i));
+* }</pre>
+*
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null
 * @since 1.8
 *
 * <p>If the generator function throws an exception, an unchecked exception
 * is thrown from {@code parallelSetAll} and the array is left in an
 * indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, in parallel, using a generator function
+* to compute each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .parallel()
+*          .forEach(i -> array[i] = generator.applyAsLong(i));
+* }</pre>
+*
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null
 * @since 1.8
 * generator function to compute each element.
 *
 * <p>If the generator function throws an exception, it is relayed to
 * the caller and the array is left in an indeterminate state.
 *
+* @apiNote
+* Setting a subrange of an array, using a generator function to compute
+* each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .forEach(i -> array[i] = generator.applyAsDouble(i));
+* }</pre>
+*
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null
 * @since 1.8
 * provided generator function to compute each element.
 *
 * <p>If the generator function throws an exception, an unchecked exception
 * is thrown from {@code parallelSetAll} and the array is left in an
 * indeterminate state.
+*
+* @apiNote
+* Setting a subrange of an array, in parallel, using a generator function
+* to compute each element, can be written as follows:
+* <pre>{@code
+* IntStream.range(startInclusive, endExclusive)
+*          .parallel()
+*          .forEach(i -> array[i] = generator.applyAsDouble(i));
+* }</pre>
 *
 * @param array array to be initialized
 * @param generator a function accepting an index and producing the desired
 *        value for that position
 * @throws NullPointerException if the generator is null

changeset 29223	a9f00e8ae58b
parent 28059	e576535359cc
child 31671	362e0c0acece
child 31540	6efd719b3330