org.perro.functions.predicate

Class LongFilterUtils

java.lang.Object

org.perro.functions.predicate.LongFilterUtils

public final class LongFilterUtils
extends java.lang.Object

Convenience methods for filtering arrays of long primitives, without having to spell out the entire stream->filter->collect process.

Method Summary

Modifier and Type	Method and Description
static <C extends java.util.Collection<java.lang.Long>> C	longFilter(long[] longs, org.perro.functions.predicate.LongFilterCollector<C> filterCollector) Filters an array of long primitives, based a predicate, into a Collection.
static long[]	longFilter(long[] longs, java.util.function.LongPredicate predicate) Filters an array of long primitives, based a predicate, into another long array.
static <C extends java.util.Collection<java.lang.Long>> org.perro.functions.predicate.LongFilterCollector<C>	longFilterAndThen(java.util.function.LongPredicate filter, java.util.stream.Collector<java.lang.Long,?,C> collector) Builds an object combining a LongPredicate and a Collector for use in the longFilter(long[], LongFilterCollector) method.
static <C extends java.util.Collection<java.lang.Long>> C	longFilterDistinct(long[] longs, org.perro.functions.predicate.LongFilterCollector<C> filterCollector) Filters an array of longs, based a predicate, into an array of distinct long values.
static long[]	longFilterDistinct(long[] longs, java.util.function.LongPredicate predicate) Filters an array of longs, based a predicate, into an array of distinct long values (according to Long.compare(long, long)).
static java.util.Set<java.lang.Long>	longFilterToSet(long[] longs, java.util.function.LongPredicate predicate) Filters an array of long primitives, based a predicate, into a Set.

Methods inherited from class java.lang.Object

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

Method Detail

longFilter

public static long[] longFilter(long[] longs,
                                java.util.function.LongPredicate predicate)

Filters an array of long primitives, based a predicate, into another long array.

Parameters:

longs - An array of longs to be filtered.

predicate - A predicate with which to filter the longs array.

Returns:

An array of longs filtered from an array of long.

longFilterToSet

public static java.util.Set<java.lang.Long> longFilterToSet(long[] longs,
                                                            java.util.function.LongPredicate predicate)

Filters an array of long primitives, based a predicate, into a Set.

Parameters:

longs - An array of longs to be filtered.

predicate - A predicate with which to filter the longs array.

Returns:

A Set of Long objects filtered from an array of long.

longFilterDistinct

public static long[] longFilterDistinct(long[] longs,
                                        java.util.function.LongPredicate predicate)

Filters an array of longs, based a predicate, into an array of distinct long values (according to Long.compare(long, long)).

Parameters:

longs - An array of longs to be filtered.

predicate - A predicate with which to filter the longs array.

Returns:

An array of distinct long values filtered, using the passed predicate, from the input array.

longFilter

public static <C extends java.util.Collection<java.lang.Long>> C longFilter(long[] longs,
                                                                            org.perro.functions.predicate.LongFilterCollector<C> filterCollector)

Filters an array of long primitives, based a predicate, into a Collection. This overload takes an object that is built using the longFilterAndThen(LongPredicate, Collector) method, which allows you to specify both a predicate and a Collector to build any type of Collection as a result. For example:

     long[] longs = ...
     List<Long> = LongFilterUtils.longFilter(longs, FilterUtils.longFilterAndThen(LongPredicateUtils.longGt(1.0D), Collectors.toCollection(LinkedList::new)));
 

Or, with static imports:

     longFilter(longs, longFilterAndThen(longGt(1.0D), toCollection(LinkedList::new)));
 

Type Parameters:

C - The type of the resulting Collection.

Parameters:

longs - An array of longs to be filtered.

filterCollector - An object containing a predicate with which to filter the longs array, and a Collector to accumulate results into a Collection.

Returns:

A Collection of Long objects filtered from an array of long.

longFilterDistinct

public static <C extends java.util.Collection<java.lang.Long>> C longFilterDistinct(long[] longs,
                                                                                    org.perro.functions.predicate.LongFilterCollector<C> filterCollector)

Filters an array of longs, based a predicate, into an array of distinct long values. This overload takes an object that is built using the longFilterAndThen(LongPredicate, Collector) method, which allows you to specify both a LongPredicate and a Collector to build any type of Collection as a result. For example:

     long[] longs = ...
     List<Long> = LongFilterUtils.longFilter(longs, LongFilterUtils.longFilterAndThen(LongPredicateUtils.longGt(1L), Collectors.toCollection(LinkedList::new)));
 

Or, with static imports:

     List<Long> = longFilter(longs, longFilterAndThen(longGt(1L), toCollection(LinkedList::new)));
 

Type Parameters:

C - The type of the resulting Collection.

Parameters:

longs - An array of longs to be filtered.

filterCollector - An object containing a predicate with which to filter the longs array, and a Collector to accumulate results into a Collection.

Returns:

An array of distinct long values filtered, using a predicate from the passed filterCollector, from the input array.

longFilterAndThen

public static <C extends java.util.Collection<java.lang.Long>> org.perro.functions.predicate.LongFilterCollector<C> longFilterAndThen(java.util.function.LongPredicate filter,
                                                                                                                                      java.util.stream.Collector<java.lang.Long,?,C> collector)

Builds an object combining a LongPredicate and a Collector for use in the longFilter(long[], LongFilterCollector) method.

Type Parameters:

C - The type of the resulting collection.

Parameters:

filter - A Predicate for filtering elements from an array of longs.

collector - A Collector to accumulate elements into a Collection of Long objects.

Returns:

A Collection of Long containing objects filtered from an array of long.