Класс StreamSupport

java.lang.Object
- java.util.stream.StreamSupport

public final class StreamSupport
extends Object

Утилитарные методы низкого уровня для создания и управления потоками.

Этот класс в основном предназначен для разработчиков библиотек, представляющих представления потоков структур данных; большинство статических методов потоков, предназначенных для конечных пользователей, находятся в различных Stream классах.

Since:: 1.8

Методы

Модификатор и тип	Метод и описание
`static DoubleStream`	`doubleStream(Spliterator.OfDouble spliterator, boolean parallel)` Создаёт новый последовательный или параллельный `DoubleStream` из `Spliterator.OfDouble`.
`static DoubleStream`	`doubleStream(Supplier<? extends Spliterator.OfDouble> supplier, int characteristics, boolean parallel)` Создаёт новый последовательный или параллельный `DoubleStream` из `Supplier` `Spliterator.OfDouble`.
`static IntStream`	`intStream(Spliterator.OfInt spliterator, boolean parallel)` Создаёт новый последовательный или параллельный `IntStream` из `Spliterator.OfInt`.
`static IntStream`	`intStream(Supplier<? extends Spliterator.OfInt> supplier, int characteristics, boolean parallel)` Создаёт новый последовательный или параллельный `IntStream` из `Supplier` `Spliterator.OfInt`.
`static LongStream`	`longStream(Spliterator.OfLong spliterator, boolean parallel)` Создаёт новый последовательный или параллельный `LongStream` из `Spliterator.OfLong`.
`static LongStream`	`longStream(Supplier<? extends Spliterator.OfLong> supplier, int characteristics, boolean parallel)` Создаёт новый последовательный или параллельный `LongStream` из `Supplier` `Spliterator.OfLong`.
`static <T> Stream<T>`	`stream(Spliterator<T> spliterator, boolean parallel)` Создаёт новый последовательный или параллельный `Stream` из `Spliterator`.
`static <T> Stream<T>`	`stream(Supplier<? extends Spliterator<T>> supplier, int characteristics, boolean parallel)` Создаёт новый последовательный или параллельный `Stream` из `Supplier` `Spliterator`.

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы

stream

public static <T> Stream<T> stream(Spliterator<T> spliterator,
                                   boolean parallel)

Создаёт новый последовательный или параллельный Stream из Spliterator.

Итератор spliterator обрабатывается, делится или запрашивается размер только после запуска заключительной операции конвейера потоков.

Сильно рекомендуется, чтобы итератор spliterator сообщал характеристику IMMUTABLE или CONCURRENT, или был поздне-связанным. В противном случае, stream(java.util.function.Supplier, int, boolean) следует использовать для уменьшения области потенциального вмешательства в источник. Смотрите Невмешательство для получения более подробной информации.

Type Parameters:: T - тип элементов потока
Parameters:: spliterator - Spliterator описывающий элементы потока; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный Stream

stream

public static <T> Stream<T> stream(Supplier<? extends Spliterator<T>> supplier,
                                   int characteristics,
                                   boolean parallel)

Создаёт новый последовательный или параллельный Stream из Supplier Spliterator.

Метод Supplier.get() будет вызван у поставщика не более одного раза и только после запуска заключительной операции конвейера потоков.

Для итераторов spliterator, которые сообщают характеристику IMMUTABLE или CONCURRENT, или которые являются поздне-связанными, вероятно, более эффективно использовать stream(java.util.Spliterator, boolean).

Использование Supplier в данном виде обеспечивает уровень косвенности, который уменьшает область потенциального вмешательства в источник. Поскольку поставщик вызывается только после запуска заключительной операции, любые изменения источника до начала заключительной операции отражаются в результате потока. Смотрите Невмешательство для получения более подробной информации.

Type Parameters:: T - тип элементов потока
Parameters:: supplier - a Supplier Spliterator; characteristics - Характеристики Spliterator для предоставленного Spliterator. Характеристики должны быть равны supplier.get().characteristics(), в противном случае может произойти неопределённое поведение при запуске заключительной операции.; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный Stream
See Also:: stream(java.util.Spliterator, boolean)

intStream

public static IntStream intStream(Spliterator.OfInt spliterator,
                                  boolean parallel)

Создаёт новый последовательный или параллельный IntStream из Spliterator.OfInt.

Сильно рекомендуется, чтобы итератор spliterator сообщал характеристику IMMUTABLE или CONCURRENT, или был поздне-связанным. В противном случае, intStream(java.util.function.Supplier, int, boolean) следует использовать для уменьшения области потенциального вмешательства в источник. Смотрите Невмешательство для получения более подробной информации.

Parameters:: spliterator - a Spliterator.OfInt описывающий элементы потока; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный IntStream

intStream

public static IntStream intStream(Supplier<? extends Spliterator.OfInt> supplier,
                                  int characteristics,
                                  boolean parallel)

Создаёт новый последовательный или параллельный IntStream из Supplier Spliterator.OfInt.

Parameters:: supplier - a Supplier Spliterator.OfInt; characteristics - Характеристики Spliterator для предоставленного Spliterator.OfInt. Характеристики должны быть равны supplier.get().characteristics(), в противном случае может произойти неопределённое поведение при запуске заключительной операции.; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный IntStream
See Also:: intStream(java.util.Spliterator.OfInt, boolean)

longStream

public static LongStream longStream(Spliterator.OfLong spliterator,
                                    boolean parallel)

Создаёт новый последовательный или параллельный LongStream из Spliterator.OfLong.

Сильно рекомендуется, чтобы итератор spliterator сообщал характеристику IMMUTABLE или CONCURRENT, или был поздне-связанным. В противном случае, longStream(java.util.function.Supplier, int, boolean) следует использовать для уменьшения области потенциального вмешательства в источник. Смотрите Невмешательство для получения более подробной информации.

Parameters:: spliterator - a Spliterator.OfLong описывающий элементы потока; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный LongStream

longStream

public static LongStream longStream(Supplier<? extends Spliterator.OfLong> supplier,
                                    int characteristics,
                                    boolean parallel)

Создаёт новый последовательный или параллельный LongStream из Supplier Spliterator.OfLong.

Parameters:: supplier - a Supplier Spliterator.OfLong; characteristics - Характеристики Spliterator для предоставленного Spliterator.OfLong. Характеристики должны быть равны supplier.get().characteristics(), в противном случае может произойти неопределённое поведение при запуске заключительной операции.; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный LongStream
See Also:: longStream(java.util.Spliterator.OfLong, boolean)

doubleStream

public static DoubleStream doubleStream(Spliterator.OfDouble spliterator,
                                        boolean parallel)

Создаёт новый последовательный или параллельный DoubleStream из Spliterator.OfDouble.

Сильно рекомендуется, чтобы итератор spliterator сообщал характеристику IMMUTABLE или CONCURRENT, или был поздне-связанным. В противном случае, doubleStream(java.util.function.Supplier, int, boolean) следует использовать для уменьшения области потенциального вмешательства в источник. Смотрите Невмешательство для получения более подробной информации.

Parameters:: spliterator - A Spliterator.OfDouble описывающий элементы потока; parallel - если true то возвращаемый поток — параллельный; если false то возвращаемый поток — последовательный.
Returns:: новый последовательный или параллельный DoubleStream

doubleStream

public static DoubleStream doubleStream(Supplier<? extends Spliterator.OfDouble> supplier,
                                        int characteristics,
                                        boolean parallel)

Создает новый последовательный или параллельный DoubleStream из Supplier Spliterator.OfDouble.

Метод Supplier.get() будет вызван на поставщике не более одного раза, и только после того, как будет начата терминальная операция конвейера потоков.

Для разделителей, которые сообщают о характеристике IMMUTABLE или CONCURRENT, или которые являются позднесвязанными, вероятно, будет эффективнее использовать doubleStream(java.util.Spliterator.OfDouble, boolean).

Использование Supplier в этом виде обеспечивает уровень косвенности, который снижает объем потенциального вмешательства в источник. Поскольку поставщик вызывается только после начала терминальной операции, любые изменения в источнике до начала терминальной операции отражаются в результате потока. Более подробную информацию см. в Невмешательство.

Параметры:: supplier - Supplier Spliterator.OfDouble; characteristics - Характеристики разделителя предоставленного Spliterator.OfDouble. Характеристики должны быть равны supplier.get().characteristics(), в противном случае может произойти неопределенное поведение при запуске терминальной операции.; parallel - если true, то возвращаемый поток является параллельным потоком; если false, то возвращаемый поток является последовательным потоком.
Возвращает:: новый последовательный или параллельный DoubleStream
См. также:: doubleStream(java.util.Spliterator.OfDouble, boolean)

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.