语言

SpliteratorCharacteristics 枚举

定义

指定拆分器报告的源属性和遍历属性。

public enum SpliteratorCharacteristics
type SpliteratorCharacteristics = 
继承
SpliteratorCharacteristics

字段

名称 值 说明
Distinct 1

特征值表示,对于每对遇到的元素 x、y、!x.equals(y)。 例如,这适用于基于集的拆分器。

Java参考java.util.Spliterator.DISTINCT。

Sorted 4

表示遇到顺序的特征值遵循定义的排序顺序。 如果是这样,则 method getComparator() 返回关联的比较器,如果所有元素都是可比的,则返回 null,并且按其自然排序。 报告 SORTED 的拆分器还必须报告 ORDERED。

Java参考java.util.Spliterator.SORTED。

Ordered 16

特征值表示为元素定义遇到顺序。 如果是这样,则此 Spliterator 保证该方法 trySplit() 拆分元素的严格前缀,该方法 tryAdvance(java.util.function.Consumer<? super T>)按前缀顺序按一个元素执行步骤,forEachRemaining(java.util.function.Consumer<?super T>)按遇到顺序执行操作。 如果相应的 Collection.iterator() 记录订单,则集合具有遇到顺序。 如果是,则遇到顺序与记录的顺序相同。 否则,集合没有遇到顺序。

Java参考java.util.Spliterator.ORDERED。

Sized 64

特征值表示在遍历或拆分之前从 estimateSize()返回的值表示有限大小,如果缺少结构源修改,则表示完全遍历将遇到的元素数的确切计数。

Java参考java.util.Spliterator.SIZED。

Nonnull 256

特征值表示源保证遇到元素不会为 null。 (例如,这适用于大多数并发集合、队列和映射。

Java参考java.util.Spliterator.NONNULL。

Immutable 1024

特征值表示无法对元素源进行结构修改;也就是说,无法添加、替换或删除元素,因此在遍历期间无法发生此类更改。 不报告 IMMUTABLE 或 CONCURRENT 的拆分器应具有记录的策略(例如引发 ConcurrentModificationException),涉及遍历期间检测到的结构干扰。

Java参考java.util.Spliterator.IMMUTABLE。

Concurrent 4096

特征值表示元素源可以安全地同时修改(允许不进行外部同步的多个线程添加、替换和/或删除)。 如果是这样,拆分器预计将有一个记录的策略,涉及遍历期间修改的影响。 顶级拆分器不应同时报告 CONCURRENT 和 SIZED,因为有限大小(如果已知)可能会在遍历期间同时修改源时发生更改。 这种拆分器不一致,无法保证使用该拆分器进行任何计算。 如果已知子拆分大小,并且遍历时不会反映源的添加或删除,则子拆分器可能会报告 SIZED。 顶级拆分器不应同时报告 CONCURRENT 和 IMMUTABLE,因为它们是互斥的。 这种拆分器不一致,无法保证使用该拆分器进行任何计算。 如果在遍历时不反映对源的添加或删除,子拆分器可能会报告 IMMUTABLE。

Java参考java.util.Spliterator.CONCURRENT。

Subsized 16384

特征值表示 trySplit() 产生的所有拆分器都将同时为 SIZED 和 SUBSIZED。 (这意味着所有子拆分器(无论是直接或间接的)都将是 SIZED。不按 SUBSIZED 要求报告 SIZED 的拆分器不一致,并且无法保证使用该拆分器进行任何计算。

Java参考java.util.Spliterator.SUBSIZED。

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于