鸿蒙OS Spliterators.AbstractSpliterator

Spliterators.AbstractSpliterator

java.lang.Object

|—java.util.Spliterators.AbstractSpliterator<T&

public abstract static class Spliterators.AbstractSpliterator<T>
extends Object
implements Spliterator<T>

实现 trySplit 以允许有限并行的抽象 Spliterator。

扩展类只需要实现 tryAdvance。 如果扩展类可以提供更高性能的实现,则应覆盖 forEach。

嵌套类摘要

从接口 java.util.Spliterator 继承的嵌套类/接口
Spliterator.OfDouble, Spliterator.OfInt, Spliterator.OfLong, Spliterator.OfPrimitive<T,T_CONS,T_SPLITR extends Spliterator.OfPrimitiveT,T_CONS,T_SPLITR>

字段摘要

从接口 java.util.Spliterator 继承的字段
CONCURRENT, DISTINCT, IMMUTABLE, NONNULL, ORDERED, SIZED, SORTED, SUBSIZED

构造函数摘要

修饰符 构造函数 描述
protected AbstractSpliterator(long est, int additionalCharacteristics) 创建一个报告给定估计大小和附加特征的拆分器。

方法总结

修饰符和类型 方法 描述
int characteristics() 返回此 Spliterator 及其元素的一组特征。
long estimateSize() 返回 Spliterator.forEachRemaining(java.util.function.Consumer) 遍历将遇到的元素数量的估计值,如果无限、未知或计算过于昂贵,则返回 Long#MAX_VALUE。
SpliteratorT trySplit() 如果此 spliterator 可以分区,则返回一个 Spliterator 覆盖元素,从该方法返回时,该 Spliterator 不会被此 Spliterator 覆盖。
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
从接口 java.util.Spliterator 继承的方法
forEachRemaining, getComparator, getExactSizeIfKnown, hasCharacteristics, tryAdvance

构造函数详细信息

AbstractSpliterator

protected AbstractSpliterator(long est, int additionalCharacteristics)

创建一个报告给定估计大小和附加特征的拆分器。

参数:

参数名称 参数描述
est 此拆分器的估计大小(如果已知),否则为 Long.MAX_VALUE。
additionalCharacteristics 此拆分器的源或元素的属性。 如果报告了 SIZED,则此拆分器将另外报告 SUBSIZED。

方法详情

trySplit

public SpliteratorT trySplit()

如果此 spliterator 可以分区,则返回一个 Spliterator 覆盖元素,从该方法返回时,该 Spliterator 不会被此 Spliterator 覆盖。

如果此 Spliterator 是 Spliterator.ORDERED,则返回的 Spliterator 必须涵盖元素的严格前缀。

除非此 Spliterator 涵盖无限数量的元素,否则对 trySplit() 的重复调用最终必须返回 null。 在非空返回时:

  • 拆分前为estimateSize() 报告的值,拆分后必须大于或等于为此和返回的Spliterator 的estimateSize(); 和
  • 如果此 Spliterator 是 SUBSIZED,则拆分前此 spliterator 的estimateSize() 必须等于此 spliterator 的estimateSize() 和拆分后返回的 Spliterator 之和。

此方法可能出于任何原因返回 null,包括空虚、遍历开始后无法拆分、数据结构约束和效率考虑。 此实现允许有限的并行性。

指定者:

接口 SpliteratorT 中的 trySplit

返回:

覆盖部分元素的 Spliterator,如果此 spliterator 无法拆分,则为 null

estimateSize

public long estimateSize()

返回 Spliterator.forEachRemaining(java.util.function.Consumer) 遍历将遇到的元素数量的估计值,如果无限、未知或计算过于昂贵,则返回 Long#MAX_VALUE。

如果此 Spliterator 是 Spliterator.SIZED 且尚未部分遍历或拆分,或者此 Spliterator 是 Spliterator.SUBSIZED 且尚未部分遍历,则此估计必须是完整遍历将遇到的元素的准确计数。 否则,这个估计可能是任意不准确的,但必须按照 Spliterator.trySplit() 调用的指定减少。

指定者:

接口 SpliteratorT 中的estimateSize

返回:

估计的大小,如果是无限的、未知的或计算成本太高,则为 Long.MAX_VALUE。

characteristics

public int characteristics()

返回此 Spliterator 及其元素的一组特征。 结果表示为 Spliterator.ORDERED、Spliterator.DISTINCT、Spliterator.SORTED、Spliterator.SIZED、Spliterator.NONNULL、Spliterator.IMMUTABLE、Spliterator.CONCURRENT、Spliterator.SUBSIZED 的 ORed 值。 在给定拆分器上重复调用特性(),在调用 trySplit 之前或之间,应该总是返回相同的结果。

如果 Spliterator 报告了一组不一致的特征(从单个调用或跨多个调用返回的特征),则无法保证使用此 Spliterator 的任何计算。

指定者:

接口 SpliteratorT 中的特征

返回:

特征的表示

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS Spliterators.AbstractSpliterator》
文章链接:https://zhuji.vsping.com/313899.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。