提交 3a7cb23a 编写于 作者: P psandoz

8020061: Clarify reporting characteristics between splits

Reviewed-by: alanb, chegar
上级 ee70762f
...@@ -414,13 +414,19 @@ public interface Spliterator<T> { ...@@ -414,13 +414,19 @@ public interface Spliterator<T> {
* #ORDERED}, {@link #DISTINCT}, {@link #SORTED}, {@link #SIZED}, * #ORDERED}, {@link #DISTINCT}, {@link #SORTED}, {@link #SIZED},
* {@link #NONNULL}, {@link #IMMUTABLE}, {@link #CONCURRENT}, * {@link #NONNULL}, {@link #IMMUTABLE}, {@link #CONCURRENT},
* {@link #SUBSIZED}. Repeated calls to {@code characteristics()} on * {@link #SUBSIZED}. Repeated calls to {@code characteristics()} on
* a given spliterator should always return the same result. * a given spliterator, prior to or in-between calls to {@code trySplit},
* should always return the same result.
* *
* <p>If a Spliterator reports an inconsistent set of * <p>If a Spliterator reports an inconsistent set of
* characteristics (either those returned from a single invocation * characteristics (either those returned from a single invocation
* or across multiple invocations), no guarantees can be made * or across multiple invocations), no guarantees can be made
* about any computation using this Spliterator. * about any computation using this Spliterator.
* *
* @apiNote The characteristics of a given spliterator before splitting
* may differ from the characteristics after splitting. For specific
* examples see the characteristic values {@link #SIZED}, {@link #SUBSIZED}
* and {@link #CONCURRENT}.
*
* @return a representation of characteristics * @return a representation of characteristics
*/ */
int characteristics(); int characteristics();
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册