树叶云鸿蒙OS教程：鸿蒙OS Spliterators

Spliterators

java.lang.Object

|—java.util.Spliterators

public final class Spliterators
extends Object

用于操作或创建 Spliterator 及其原始特化 Spliterator.OfInt、Spliterator.OfLong 和 Spliterator.OfDouble 实例的静态类和方法。

嵌套类摘要

方法总结

方法详情

emptySpliterator

public static <T> Spliterator<T> emptySpliterator()

创建一个空的 Spliterator

空拆分器报告 Spliterator#SIZED 和 Spliterator#SUBSIZED。 对 Spliterator.trySplit() 的调用总是返回 null。

类型参数：

返回:

一个空的分离器

emptyIntSpliterator

public static Spliterator.OfInt emptyIntSpliterator()

创建一个空的 Spliterator.OfInt

空拆分器报告 Spliterator#SIZED 和 Spliterator#SUBSIZED。 对 Spliterator.trySplit() 的调用总是返回 null。

返回：

一个空的分离器

emptyLongSpliterator

public static Spliterator.OfLong emptyLongSpliterator()

创建一个空的 Spliterator.OfLong

空拆分器报告 Spliterator#SIZED 和 Spliterator#SUBSIZED。 对 Spliterator.trySplit() 的调用总是返回 null。

返回：

一个空的分离器

emptyDoubleSpliterator

public static Spliterator.OfDouble emptyDoubleSpliterator()

创建一个空的 Spliterator.OfDouble

空拆分器报告 Spliterator#SIZED 和 Spliterator#SUBSIZED。 对 Spliterator.trySplit() 的调用总是返回 null。

返回：

一个空的分离器

spliterator

public static <T> Spliterator<T> spliterator(Object[] array, int additionalCharacteristics)

使用一组自定义的拆分器特征创建一个覆盖给定数组元素的拆分器。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(Object])。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以提供额外的特征给分离器报告； 通常额外指定 IMMUTABLE 和 ORDERED。

类型参数：

参数:

返回:

数组的拆分器

Throws:

spliterator

public static <T> Spliterator<T> spliterator(Object[] array, int fromIndex, int toIndex, int additionalCharacteristics)

使用一组自定义的拆分器特征创建一个涵盖给定数组的一系列元素的拆分器。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(Object])。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以提供额外的特征给分离器报告； 通常额外指定 IMMUTABLE 和 ORDERED。

类型参数：

参数:

返回:

数组的拆分器

Throws:

spliterator

public static Spliterator.OfInt spliterator(int[] array, int additionalCharacteristics)

创建一个 Spliterator.OfInt 覆盖给定数组的元素，使用一组自定义的拆分器特征。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(int])。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以提供额外的特征给分离器报告； 通常额外指定 IMMUTABLE 和 ORDERED。

参数：

返回:

数组的拆分器

Throws:

spliterator

public static Spliterator.OfInt spliterator(int[] array, int fromIndex, int toIndex, int additionalCharacteristics)

创建一个 Spliterator.OfInt 覆盖给定数组的一系列元素，使用一组自定义的拆分器特征。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(int], int, int)。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以提供额外的特征给分离器报告； 通常额外指定 IMMUTABLE 和 ORDERED。

参数：

返回:

数组的拆分器

Throws:

spliterator

public static Spliterator.OfLong spliterator(long[] array, int additionalCharacteristics)

创建一个 Spliterator.OfLong 覆盖给定数组的元素，使用一组自定义的拆分器特征。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(long])。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以提供额外的特征给分离器报告； 通常额外指定 IMMUTABLE 和 ORDERED。

参数：

返回:

数组的拆分器

Throws:

spliterator

public static Spliterator.OfLong spliterator(long[] array, int fromIndex, int toIndex, int additionalCharacteristics)

创建一个 Spliterator.OfLong 覆盖给定数组的一系列元素，使用一组自定义的拆分器特征。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(long], int, int)。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以为拆分器提供额外的特性来报告。 （例如，如果已知数组不会被进一步修改，则指定 IMMUTABLE；如果认为数组数据具有遇到顺序，则指定 ORDERED）。 通常可以使用 [Arrays#spliterator(long], int, int) 方法，它返回一个拆分器，报告 SIZED、SUBSIZED、IMMUTABLE 和 ORDERED。

参数：

返回:

数组的拆分器

Throws:

spliterator

public static Spliterator.OfDouble spliterator(double[] array, int additionalCharacteristics)

创建一个 Spliterator.OfDouble 覆盖给定数组的元素，使用一组自定义的拆分器特征。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(double])。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以提供额外的特征给分离器报告； 通常额外指定 IMMUTABLE 和 ORDERED。

参数：

返回:

数组的拆分器

Throws:

spliterator

public static Spliterator.OfDouble spliterator(double[] array, int fromIndex, int toIndex, int additionalCharacteristics)

创建一个 Spliterator.OfDouble 覆盖给定数组的一系列元素，使用一组自定义的拆分器特征。

提供此方法是为了方便将部分元素存储在数组中的 Spliterators 实现方便，并且需要对 Spliterator 特性进行精细控制。 大多数其他需要数组拆分器的情况应使用 [Arrays#spliterator(double], int, int)。

返回的拆分器始终报告 SIZED 和 SUBSIZED 特征。 调用者可以为拆分器提供额外的特性来报告。 （例如，如果已知数组不会被进一步修改，则指定 IMMUTABLE；如果认为数组数据具有遇到顺序，则指定 ORDERED）。 通常可以使用 [Arrays#spliterator(long], int, int) 方法，它返回一个拆分器，报告 SIZED、SUBSIZED、IMMUTABLE 和 ORDERED。

参数：

返回:

数组的拆分器

Throws:

spliterator

public static <T> Spliterator<T> spliterator(Collection<? extends T> c, int characteristics)

使用给定集合的 Collection.iterator() 作为元素源创建 Spliterator，并将其 Collection.size() 报告为其初始大小。

spliterator 是后期绑定的，继承了集合迭代器的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

类型参数：

参数:

返回:

来自迭代器的拆分器

Throws:

spliterator

public static <T> Spliterator<T> spliterator(Iterator<? extends T> iterator, long size, int characteristics)

使用给定的迭代器作为元素的源创建一个拆分器，并具有给定的初始报告大小。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，或者最初报告的大小不等于源中的实际元素数，则拆分和遍历的行为是不确定的。

类型参数：

参数:

返回:

来自迭代器的拆分器

Throws:

spliteratorUnknownSize

public static <T> Spliterator<T> spliteratorUnknownSize(Iterator<? extends T> iterator, int characteristics)

使用给定的迭代器作为元素的源创建一个拆分器，没有初始大小估计。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，则拆分和遍历的行为是不确定的。

类型参数：

参数:

返回:

来自迭代器的拆分器

Throws:

spliterator

public static Spliterator.OfInt spliterator(PrimitiveIterator.OfInt iterator, long size, int characteristics)

使用给定的 IntStream.IntIterator 作为元素的源创建一个 Spliterator.OfInt，并具有给定的初始报告大小。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，或者最初报告的大小不等于源中的实际元素数，则拆分和遍历的行为是不确定的。

参数：

返回:

来自迭代器的拆分器

Throws:

spliteratorUnknownSize

public static Spliterator.OfInt spliteratorUnknownSize(PrimitiveIterator.OfInt iterator, int characteristics)

使用给定的 IntStream.IntIterator 作为元素源创建 Spliterator.OfInt，没有初始大小估计。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，则拆分和遍历的行为是不确定的。

参数：

返回:

来自迭代器的拆分器

Throws:

spliterator

public static Spliterator.OfLong spliterator(PrimitiveIterator.OfLong iterator, long size, int characteristics)

创建一个 Spliterator.OfLong 使用给定的 LongStream.LongIterator 作为元素的源，并具有给定的初始报告大小。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，或者最初报告的大小不等于源中的实际元素数，则拆分和遍历的行为是不确定的。

参数：

返回:

来自迭代器的拆分器

Throws:

spliteratorUnknownSize

public static Spliterator.OfLong spliteratorUnknownSize(PrimitiveIterator.OfLong iterator, int characteristics)

使用给定的 LongStream.LongIterator 作为元素源创建 Spliterator.OfLong，没有初始大小估计。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，则拆分和遍历的行为是不确定的。

参数：

返回:

来自迭代器的拆分器

Throws:

spliterator

public static Spliterator.OfDouble spliterator(PrimitiveIterator.OfDouble iterator, long size, int characteristics)

使用给定的 DoubleStream.DoubleIterator 作为元素的源创建一个 Spliterator.OfDouble，并具有给定的初始报告大小。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，或者最初报告的大小不等于源中的实际元素数，则拆分和遍历的行为是不确定的。

参数：

返回:

来自迭代器的拆分器

Throws:

spliteratorUnknownSize

public static Spliterator.OfDouble spliteratorUnknownSize(PrimitiveIterator.OfDouble iterator, int characteristics)

使用给定的 DoubleStream.DoubleIterator 作为元素源创建一个 Spliterator.OfDouble，没有初始大小估计。

spliterator 不是后期绑定的，它继承了 iterator 的 fail-fast 属性，并实现了 trySplit 以允许有限的并行性。

元素的遍历应该通过拆分器来完成。 如果在拆分器返回后对迭代器进行操作，则拆分和遍历的行为是不确定的。

参数：

返回:

来自迭代器的拆分器

Throws:

iterator

public static <T> Iterator<T> iterator(Spliterator<? extends T> spliterator)

从 Spliterator 创建一个 Iterator。

元素的遍历应该通过迭代器来完成。 如果在迭代器返回后操作拆分器，则遍历的行为是不确定的。

类型参数：

参数:

返回:

一个迭代器

Throws:

iterator

public static PrimitiveIterator.OfInt iterator(Spliterator.OfInt spliterator)

从 Spliterator.OfInt 创建 PrimitiveIterator.OfInt。

元素的遍历应该通过迭代器来完成。 如果在迭代器返回后操作拆分器，则遍历的行为是不确定的。

参数：

返回:

一个迭代器

Throws:

iterator

public static PrimitiveIterator.OfLong iterator(Spliterator.OfLong spliterator)

从 Spliterator.OfLong 创建 PrimitiveIterator.OfLong。

元素的遍历应该通过迭代器来完成。 如果在迭代器返回后操作拆分器，则遍历的行为是不确定的。

参数：

返回:

一个迭代器

Throws:

iterator

public static PrimitiveIterator.OfDouble iterator(Spliterator.OfDouble spliterator)

从 Spliterator.OfDouble 创建 PrimitiveIterator.OfDouble。

元素的遍历应该通过迭代器来完成。 如果在迭代器返回后操作拆分器，则遍历的行为是不确定的。

参数：

返回:

一个迭代器

Throws: