程序包 committee.nova.mods.avaritia.api.util.java

接口 StreamableIterable<T>

所有超级接口:

Iterable<T>

public interface StreamableIterable<T>
extends Iterable<T>

StreamableIterable

字段概要

字段

修饰符和类型	字段	说明
static final StreamableIterable<?>	EMPTY	Static empty instance.

方法概要

修饰符和类型	方法	说明
default boolean	allMatch(Predicate<? super T> test)	Check if all elements in this StreamableIterable match the given predicate.
default boolean	anyMatch(Predicate<? super T> test)	Check if any elements in this StreamableIterable match the given predicate.
default StreamableIterable<T>	concat(Iterable<? extends T> other)	Concatenates another StreamableIterable onto this one.
static <T> StreamableIterable<T>	concat(Iterable<? extends T>... iterables)	Returns an StreamableIterable containing the elements from all the provided iterables concatenated together.
static <T> StreamableIterable<T>	concatMany(Iterable<? extends Iterable<? extends T>> iterables)	Returns an StreamableIterable containing the elements from all the provided iterables concatenated together.
default int	count()	Count the number of elements in this StreamableIterable.
default StreamableIterable<T>	distinct()	Filter the elements in this StreamableIterable by their hashcode/equals.
default double	doubleSum(ToDoubleFunction<? super T> func)	Map all elements of this StreamableIterable to a double, then sum the result.
static <T> StreamableIterable<T>	empty()	Returns an empty StreamableIterable.
default StreamableIterable<T>	filter(Predicate<? super T> pred)	Filter the elements in this StreamableIterable by matching a Predicate.
default StreamableIterable<T>	filterNot(Predicate<? super T> pred)	Filter the elements in this StreamableIterable by matching a Predicate.
default <R> StreamableIterable<R>	flatMap(Function<? super T,? extends Iterable<? extends R>> func)	Flat map the elements in this StreamableIterable.
default Optional<T>	fold(BinaryOperator<T> accumulator)	Folds each element of this StreamableIterable into the previous.
default T	fold(T identity, BinaryOperator<@Nullable T> accumulator)	已过时。 Remains for ABI compat.
default <U> U	fold(U identity, BiFunction<? super @Nullable U,? super T,? extends U> accumulator)	Folds each element of this StreamableIterable into the previous.
default <K> HashMap<K,List<T>>	groupBy(Function<T,K> keyFunc)	Collects this StreamableIterable into a HashMap grouped by a key.
default <K, V> HashMap<K,List<V>>	groupBy(Function<T,K> keyFunc, Function<T,V> valueFunc)	Collects this StreamableIterable into a HashMap grouped by a key.
default <K, V, L extends List<V>, M extends Map<K, L>> M	groupBy(M map, Supplier<L> listFactory, Function<T,K> keyFunc, Function<T,V> valueFunc)	Collects this StreamableIterable into a Map grouped by a key.
default <K> com.google.common.collect.ImmutableMap<K,List<T>>	groupByImmutable(Function<T,K> keyFunc)	Collects this StreamableIterable into a ImmutableMap grouped by a key.
default <K, V> com.google.common.collect.ImmutableMap<K,List<V>>	groupByImmutable(Function<T,K> keyFunc, Function<T,V> valueFunc)	Collects this StreamableIterable into a ImmutableMap grouped by a key.
default <K> LinkedHashMap<K,List<T>>	groupByLinked(Function<T,K> keyFunc)	Collects this StreamableIterable into a LinkedHashMap grouped by a key.
default <K, V> LinkedHashMap<K,List<V>>	groupByLinked(Function<T,K> keyFunc, Function<T,V> valueFunc)	Collects this StreamableIterable into a LinkedHashMap grouped by a key.
default int	intSum(ToIntFunction<? super T> func)	Map all elements of this StreamableIterable to an int, then sum the result.
default boolean	isEmpty()
default String	join(String sep)	Join all elements of the StreamableIterable together into a String, seperated by sep.
default StreamableIterable<T>	limit(@org.jetbrains.annotations.Range(from=-1L, to=2147483647L) int max)	Limit the number of elements returned by this StreamableIterable to the given value.
default long	longSum(ToLongFunction<? super T> func)	Map all elements of this StreamableIterable to a long, then sum the result.
default <R> StreamableIterable<R>	map(Function<? super T,? extends R> func)	Transform the elements in this StreamableIterable.
default boolean	noneMatch(Predicate<? super T> test)	Check if no elements in this StreamableIterable match the given predicate.
static <T> StreamableIterable<T>	of()	Returns an empty StreamableIterable.
static <T> StreamableIterable<T>	of(Iterable<? extends T> itr)	Constructs a StreamableIterable wrapper from the given Iterable.
static <T> StreamableIterable<T>	of(Optional<? extends T> optional)	Creates an StreamableIterable for an Optional value.
static <T> StreamableIterable<T>	of(T thing)	Creates a StreamableIterable for single input.
static <T> StreamableIterable<T>	of(T... things)	Creates an StreamableIterable from a variable list of inputs.
static <T> StreamableIterable<T>	ofNullable(T thing)	Creates an StreamableIterable for a Nullable value.
default Stream<T>	parallelStream()	Convert this StreamableIterable to a parallel Stream.
default StreamableIterable<T>	peek(Consumer<? super T> action)	Peek the elements of this StreamableIterable as they are consumed.
default StreamableIterable<T>	skip(@org.jetbrains.annotations.Range(from=0L, to=2147483647L) int n)	Skip n number of elements in this StreamableIterable.
default Stream<T>	stream()	Convert this StreamableIterable to a Stream.
default Object[]	toArray()	Collect this StreamableIterable to an array.
default T[]	toArray(T[] arr)	Collect this StreamableIterable to an array.
default com.google.common.collect.ImmutableList<T>	toImmutableList()	Collect this StreamableIterable to an ImmutableList.
default <K, V> com.google.common.collect.ImmutableMap<K,V>	toImmutableMap(Function<T,K> keyFunc, Function<T,V> valueFunc)	Collect this StreamableIterable to am ImmutableMap.
default <K, V> com.google.common.collect.ImmutableMap<K,V>	toImmutableMap(Function<T,K> keyFunc, Function<T,V> valueFunc, BinaryOperator<V> mergeFunc)	Collect this StreamableIterable to am ImmutableMap.
default com.google.common.collect.ImmutableSet<T>	toImmutableSet()	Collect this StreamableIterable to a LinkedHashSet.
default <K, V> HashMap<K,V>	toLinkedHashMap(Function<T,K> keyFunc, Function<T,V> valueFunc)	Collect this StreamableIterable to a LinkedHashMap.
default <K, V> HashMap<K,V>	toLinkedHashMap(Function<T,K> keyFunc, Function<T,V> valueFunc, BinaryOperator<V> mergeFunc)	Collect this StreamableIterable to a LinkedHashMap.
default LinkedHashSet<T>	toLinkedHashSet()	Collect this StreamableIterable to a LinkedHashSet.
default LinkedList<T>	toLinkedList()	Collect this StreamableIterable to a LinkedList.
default ArrayList<T>	toList()	Collect this StreamableIterable to an ArrayList.
default <K, V> HashMap<K,V>	toMap(Function<T,K> keyFunc, Function<T,V> valueFunc)	Collect this StreamableIterable to a HashMap.
default <K, V> HashMap<K,V>	toMap(Function<T,K> keyFunc, Function<T,V> valueFunc, BinaryOperator<V> mergeFunc)	Collect this StreamableIterable to a HashMap.
default <K, V, M extends Map<K, V>> M	toMap(M map, Function<T,K> keyFunc, Function<T,V> valueFunc)	Collect this StreamableIterable to a Map.
default <K, V, M extends Map<K, V>> M	toMap(M map, Function<T,K> keyFunc, Function<T,V> valueFunc, BinaryOperator<V> mergeFunc)	Collect this StreamableIterable to a Map.
default HashSet<T>	toSet()	Collect this StreamableIterable to a HashSet.

从接口继承的方法 java.lang.Iterable

forEach, iterator, spliterator

字段详细资料

EMPTY

static final StreamableIterable<?> EMPTY

Static empty instance. You want empty().

方法详细资料

empty

static <T> StreamableIterable<T> empty()

Returns an empty StreamableIterable.

返回:

The empty StreamableIterable

of

static <T> StreamableIterable<T> of(Iterable<? extends T> itr)

Constructs a StreamableIterable wrapper from the given Iterable.

参数:

itr - The Iterable to wrap.

返回:

The StreamableIterable

of

static <T> StreamableIterable<T> of()

Returns an empty StreamableIterable.

返回:

The empty StreamableIterable

of

static <T> StreamableIterable<T> of(T thing)

Creates a StreamableIterable for single input.

参数:

thing - The thing.

返回:

the StreamableIterable.

ofNullable

static <T> StreamableIterable<T> ofNullable(@Nullable
 T thing)

Creates an StreamableIterable for a Nullable value.

If the value provided is null, this method will return empty(), otherwise it will return a new StreamableIterable containing only the value provided.

参数:

thing - The thing.

返回:

The StreamableIterable.

of

static <T> StreamableIterable<T> of(Optional<? extends T> optional)

Creates an StreamableIterable for an Optional value.

If the value provided is not present, this method will return empty(), otherwise it will return a new StreamableIterable containing only the value provided.

参数:

optional - The thing.

返回:

The StreamableIterable.

of

@SafeVarargs
static <T> StreamableIterable<T> of(T... things)

Creates an StreamableIterable from a variable list of inputs.

参数:

things - The things.

返回:

the StreamableIterable.

concat

@SafeVarargs
static <T> StreamableIterable<T> concat(Iterable<? extends T>... iterables)

Returns an StreamableIterable containing the elements from all the provided iterables concatenated together.

参数:

iterables - The Iterables to concatenate.

返回:

The concatenated StreamableIterable.

concatMany

static <T> StreamableIterable<T> concatMany(Iterable<? extends Iterable<? extends T>> iterables)

Returns an StreamableIterable containing the elements from all the provided iterables concatenated together.

参数:

iterables - The Iterables to concatenate.

返回:

The concatenated StreamableIterable.

concat

default StreamableIterable<T> concat(Iterable<? extends T> other)

Concatenates another StreamableIterable onto this one.

参数:

other - The other Iterable to append.

返回:

The new concatenated StreamableIterable.

filter

default StreamableIterable<T> filter(Predicate<? super T> pred)

Filter the elements in this StreamableIterable by matching a Predicate.

All elements which match this Predicate will be in the resulting StreamableIterable.

参数:

pred - The predicate.

返回:

A wrapped StreamableIterable with the filter applied.

filterNot

default StreamableIterable<T> filterNot(Predicate<? super T> pred)

Filter the elements in this StreamableIterable by matching a Predicate.

All elements which do not match this Predicate will be in the resulting StreamableIterable.

参数:

pred - The predicate.

返回:

A wrapped StreamableIterable with the filter applied.

map

default <R> StreamableIterable<R> map(Function<? super T,? extends R> func)

Transform the elements in this StreamableIterable.

参数:

func - The Function to transform with.

返回:

A wrapped StreamableIterable with the mapped elements.

flatMap

default <R> StreamableIterable<R> flatMap(Function<? super T,? extends Iterable<? extends R>> func)

Flat map the elements in this StreamableIterable.

参数:

func - The function to get/create the iterable for a given element.

返回:

A wrapped StreamableIterable with the flat mapped elements.

distinct

default StreamableIterable<T> distinct()

Filter the elements in this StreamableIterable by their hashcode/equals.

返回:

A wrapped StreamableIterable with the filtered elements.

peek

default StreamableIterable<T> peek(Consumer<? super T> action)

Peek the elements of this StreamableIterable as they are consumed.

参数:

action - The consumer.

返回:

A wrapped StreamableIterable with the peek function applied.

limit

default StreamableIterable<T> limit(@org.jetbrains.annotations.Range(from=-1L, to=2147483647L) int max)

Limit the number of elements returned by this StreamableIterable to the given value.

参数:

max - The limit. -1 for infinite.

返回:

A wrapped StreamableIterable with the max filter applied. In the event -1 is supplied, the same StreamableIterable will be provided. In the event 0 is supplied, an empty StreamableIterable will be provided.

skip

default StreamableIterable<T> skip(@org.jetbrains.annotations.Range(from=0L, to=2147483647L) int n)

Skip n number of elements in this StreamableIterable.

参数:

n - The number of elements to skip.

返回:

A wrapped StreamableIterable with the max filter applied. In the event 0 is supplied, the same StreamableIterable will be provided.

toArray

default Object[] toArray()

Collect this StreamableIterable to an array.

返回:

The array.

toArray

default T[] toArray(T[] arr)

Collect this StreamableIterable to an array.

参数:

arr - The array to add the elements to. If all elements to not fit in this array a new array will be returned of appropriate size.

返回:

Either the array passed in or one of appropriate size with all elements of the Iterable.

fold

@Nullable
@Contract("!null,_ -> !null")
@Deprecated
@ScheduledForRemoval(inVersion="0.5.0")
default T fold(@Nullable
 T identity,
 BinaryOperator<@Nullable T> accumulator)

已过时。

Remains for ABI compat.

Folds each element of this StreamableIterable into the previous.

参数:

identity - The starting element.

accumulator - The function to fold elements with.

返回:

The result.

fold

@Nullable
@Contract("!null,_ -> !null")
default <U> U fold(@Nullable
 U identity,
 BiFunction<? super @Nullable U,? super T,? extends U> accumulator)

Folds each element of this StreamableIterable into the previous.

参数:

identity - The starting element.

accumulator - The function to fold elements with.

返回:

The result.

fold

default Optional<T> fold(BinaryOperator<T> accumulator)

Folds each element of this StreamableIterable into the previous.

参数:

accumulator - The function to fold elements with.

返回:

The result. Empty if no elements exist.

count

default int count()

Count the number of elements in this StreamableIterable.

返回:

The number of elements.

intSum

default int intSum(ToIntFunction<? super T> func)

Map all elements of this StreamableIterable to an int, then sum the result.

参数:

func - The mapping function.

返回:

The sum result.

longSum

default long longSum(ToLongFunction<? super T> func)

Map all elements of this StreamableIterable to a long, then sum the result.

参数:

func - The mapping function.

返回:

The sum result.

doubleSum

default double doubleSum(ToDoubleFunction<? super T> func)

Map all elements of this StreamableIterable to a double, then sum the result.

参数:

func - The mapping function.

返回:

The sum result.

isEmpty

default boolean isEmpty()

返回:

If this StreamableIterable is empty.

anyMatch

default boolean anyMatch(Predicate<? super T> test)

Check if any elements in this StreamableIterable match the given predicate.

参数:

test - The predicate.

返回:

The result.

allMatch

default boolean allMatch(Predicate<? super T> test)

Check if all elements in this StreamableIterable match the given predicate.

参数:

test - The predicate.

返回:

The result.

noneMatch

default boolean noneMatch(Predicate<? super T> test)

Check if no elements in this StreamableIterable match the given predicate.

参数:

test - The predicate.

返回:

The result.

toList

default ArrayList<T> toList()

Collect this StreamableIterable to an ArrayList.

返回:

The ArrayList.

toLinkedList

default LinkedList<T> toLinkedList()

Collect this StreamableIterable to a LinkedList.

返回:

The LinkedList.

toImmutableList

default com.google.common.collect.ImmutableList<T> toImmutableList()

Collect this StreamableIterable to an ImmutableList.

返回:

The ImmutableList.

toSet

default HashSet<T> toSet()

Collect this StreamableIterable to a HashSet.

返回:

The HashSet.

toLinkedHashSet

default LinkedHashSet<T> toLinkedHashSet()

Collect this StreamableIterable to a LinkedHashSet.

返回:

The LinkedHashSet.

toImmutableSet

default com.google.common.collect.ImmutableSet<T> toImmutableSet()

Collect this StreamableIterable to a LinkedHashSet.

返回:

The LinkedHashSet.

toMap

default <K,
V> HashMap<K,V> toMap(Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collect this StreamableIterable to a HashMap. This method will always resolve the existing element on collision.

参数:

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

返回:

The Map.

toMap

default <K,
V> HashMap<K,V> toMap(Function<T,K> keyFunc,
 Function<T,V> valueFunc,
 BinaryOperator<V> mergeFunc)

Collect this StreamableIterable to a HashMap.

参数:

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

mergeFunc - The function for merging 2 values on collision. (Left existing, Right toAdd)

返回:

The Map.

toLinkedHashMap

default <K,
V> HashMap<K,V> toLinkedHashMap(Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collect this StreamableIterable to a LinkedHashMap. This method will always resolve the existing element on collision.

参数:

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

返回:

The Map.

toLinkedHashMap

default <K,
V> HashMap<K,V> toLinkedHashMap(Function<T,K> keyFunc,
 Function<T,V> valueFunc,
 BinaryOperator<V> mergeFunc)

Collect this StreamableIterable to a LinkedHashMap.

参数:

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

mergeFunc - The function for merging 2 values on collision. (Left existing, Right toAdd)

返回:

The Map.

toImmutableMap

default <K,
V>
com.google.common.collect.ImmutableMap<K,V> toImmutableMap(Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collect this StreamableIterable to am ImmutableMap.

This function collects to an intermediate LinkedHashMap internally, iteration order will be preserved.

参数:

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

返回:

The ImmutableMap.

toImmutableMap

default <K,
V>
com.google.common.collect.ImmutableMap<K,V> toImmutableMap(Function<T,K> keyFunc,
 Function<T,V> valueFunc,
 BinaryOperator<V> mergeFunc)

Collect this StreamableIterable to am ImmutableMap.

This function collects to an intermediate LinkedHashMap internally, iteration order will be preserved.

参数:

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

mergeFunc - The function for merging 2 values on collision. (Left existing, Right toAdd)

返回:

The ImmutableMap.

toMap

default <K,
V,
M extends Map<K,
V>> M toMap(M map,
 Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collect this StreamableIterable to a Map. This method will always resolve the existing element on collision.

参数:

map - The map to add the elements to.

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

返回:

The same map that was passed in.

toMap

default <K,
V,
M extends Map<K,
V>> M toMap(M map,
 Function<T,K> keyFunc,
 Function<T,V> valueFunc,
 BinaryOperator<V> mergeFunc)

Collect this StreamableIterable to a Map.

参数:

map - The map to add the elements to.

keyFunc - The function for extracting the key.

valueFunc - The function for extracting the value.

mergeFunc - The function for merging 2 values on collision. (Left existing, Right toAdd)

返回:

The same map that was passed in.

groupBy

default <K> HashMap<K,List<T>> groupBy(Function<T,K> keyFunc)

Collects this StreamableIterable into a HashMap grouped by a key.

This function uses ArrayList values.

参数:

keyFunc - The function to extract the Map key.

返回:

The HashMap representing the grouped values.

groupBy

default <K,
V> HashMap<K,List<V>> groupBy(Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collects this StreamableIterable into a HashMap grouped by a key.

This function uses ArrayList values.

参数:

keyFunc - The function to extract the Map key.

valueFunc - The function to extract the List value.

返回:

The HashMap representing the grouped values.

groupByLinked

default <K> LinkedHashMap<K,List<T>> groupByLinked(Function<T,K> keyFunc)

Collects this StreamableIterable into a LinkedHashMap grouped by a key.

This function uses LinkedList values.

参数:

keyFunc - The function to extract the LinkedHashMap key.

返回:

The LinkedHashMap representing the grouped values.

groupByLinked

default <K,
V> LinkedHashMap<K,List<V>> groupByLinked(Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collects this StreamableIterable into a LinkedHashMap grouped by a key.

This function uses LinkedList values.

This function will preserve iteration order.

参数:

keyFunc - The function to extract the LinkedHashMap key.

valueFunc - The function to extract the LinkedList value.

返回:

The LinkedHashMap representing the grouped values.

groupByImmutable

default <K>
com.google.common.collect.ImmutableMap<K,List<T>> groupByImmutable(Function<T,K> keyFunc)

Collects this StreamableIterable into a ImmutableMap grouped by a key.

This function uses ImmutableList values.

This function will preserve iteration order.

参数:

keyFunc - The function to extract the ImmutableMap key.

返回:

The ImmutableMap representing the grouped values.

groupByImmutable

default <K,
V>
com.google.common.collect.ImmutableMap<K,List<V>> groupByImmutable(Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collects this StreamableIterable into a ImmutableMap grouped by a key.

This function uses ImmutableList values.

This function will preserve iteration order.

参数:

keyFunc - The function to extract the ImmutableMap key.

valueFunc - The function to extract the ImmutableList value.

返回:

The ImmutableMap representing the grouped values.

groupBy

default <K,
V,
L extends List<V>,
M extends Map<K,
L>>
M groupBy(M map,
 Supplier<L> listFactory,
 Function<T,K> keyFunc,
 Function<T,V> valueFunc)

Collects this StreamableIterable into a Map grouped by a key.

参数:

map - The map to collect into.

listFactory - The function to construct List instances.

keyFunc - The function to extract the Map key.

valueFunc - The function to extract the List value.

返回:

The same map that was passed in.

join

default String join(String sep)

Join all elements of the StreamableIterable together into a String, seperated by sep.

参数:

sep - The separator.

返回:

The joined string.

stream

default Stream<T> stream()

Convert this StreamableIterable to a Stream.

返回:

The Stream

parallelStream

default Stream<T> parallelStream()

Convert this StreamableIterable to a parallel Stream.

返回:

The Stream