SpliteratorCharacteristics 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定拆分器报告的源属性和遍历属性。
public enum SpliteratorCharacteristics
type SpliteratorCharacteristics =
- 继承
-
SpliteratorCharacteristics
字段
| 名称 | 值 | 说明 |
|---|---|---|
| Distinct | 1 | 特征值表示,对于每对遇到的元素 x、y、!x.equals(y)。 例如,这适用于基于集的拆分器。 |
| Sorted | 4 | 表示遇到顺序的特征值遵循定义的排序顺序。 如果是这样,则 method getComparator() 返回关联的比较器,如果所有元素都是可比的,则返回 null,并且按其自然排序。 报告 SORTED 的拆分器还必须报告 ORDERED。 |
| Ordered | 16 | 特征值表示为元素定义遇到顺序。 如果是这样,则此 Spliterator 保证该方法 trySplit() 拆分元素的严格前缀,该方法 tryAdvance(java.util.function.Consumer<? super T>)按前缀顺序按一个元素执行步骤,forEachRemaining(java.util.function.Consumer<?super T>)按遇到顺序执行操作。 如果相应的 Collection.iterator() 记录订单,则集合具有遇到顺序。 如果是,则遇到顺序与记录的顺序相同。 否则,集合没有遇到顺序。 |
| Sized | 64 | 特征值表示在遍历或拆分之前从 estimateSize()返回的值表示有限大小,如果缺少结构源修改,则表示完全遍历将遇到的元素数的确切计数。 |
| Nonnull | 256 | 特征值表示源保证遇到元素不会为 null。 (例如,这适用于大多数并发集合、队列和映射。 |
| Immutable | 1024 | 特征值表示无法对元素源进行结构修改;也就是说,无法添加、替换或删除元素,因此在遍历期间无法发生此类更改。 不报告 IMMUTABLE 或 CONCURRENT 的拆分器应具有记录的策略(例如引发 ConcurrentModificationException),涉及遍历期间检测到的结构干扰。 |
| Concurrent | 4096 | 特征值表示元素源可以安全地同时修改(允许不进行外部同步的多个线程添加、替换和/或删除)。 如果是这样,拆分器预计将有一个记录的策略,涉及遍历期间修改的影响。 顶级拆分器不应同时报告 CONCURRENT 和 SIZED,因为有限大小(如果已知)可能会在遍历期间同时修改源时发生更改。 这种拆分器不一致,无法保证使用该拆分器进行任何计算。 如果已知子拆分大小,并且遍历时不会反映源的添加或删除,则子拆分器可能会报告 SIZED。 顶级拆分器不应同时报告 CONCURRENT 和 IMMUTABLE,因为它们是互斥的。 这种拆分器不一致,无法保证使用该拆分器进行任何计算。 如果在遍历时不反映对源的添加或删除,子拆分器可能会报告 IMMUTABLE。 |
| Subsized | 16384 | 特征值表示 trySplit() 产生的所有拆分器都将同时为 SIZED 和 SUBSIZED。 (这意味着所有子拆分器(无论是直接或间接的)都将是 SIZED。不按 SUBSIZED 要求报告 SIZED 的拆分器不一致,并且无法保证使用该拆分器进行任何计算。 |
注解
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。