org.perro.functions.predicate

Class IntFilterUtils

java.lang.Object

org.perro.functions.predicate.IntFilterUtils

public final class IntFilterUtils
extends java.lang.Object

Convenience methods for filtering arrays of int 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.Integer>> C	intFilter(int[] ints, org.perro.functions.predicate.IntFilterCollector<C> filterCollector) Filters an array of ints, based a predicate, into a collection.
static int[]	intFilter(int[] ints, java.util.function.IntPredicate predicate) Filters an array of ints, based a predicate, into another int array.
static <C extends java.util.Collection<java.lang.Integer>> org.perro.functions.predicate.IntFilterCollector<C>	intFilterAndThen(java.util.function.IntPredicate filter, java.util.stream.Collector<java.lang.Integer,?,C> collector) Builds an object combining a IntPredicate and a Collector for use in the intFilter(int[], IntFilterCollector) method.
static <C extends java.util.Collection<java.lang.Integer>> C	intFilterDistinct(int[] ints, org.perro.functions.predicate.IntFilterCollector<C> filterCollector) Filters an array of ints, based a predicate, into an array of distinct int values.
static int[]	intFilterDistinct(int[] ints, java.util.function.IntPredicate predicate) Filters an array of ints, based a predicate, into an array of distinct int values (according to Integer.compare(int, int)).
static java.util.Set<java.lang.Integer>	intFilterToSet(int[] ints, java.util.function.IntPredicate predicate) Filters an array of ints, 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

intFilter

public static int[] intFilter(int[] ints,
                              java.util.function.IntPredicate predicate)

Filters an array of ints, based a predicate, into another int array.

Parameters:

ints - An array of ints to be filtered.

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

Returns:

An array of ints filtered from an array of int.

intFilterToSet

public static java.util.Set<java.lang.Integer> intFilterToSet(int[] ints,
                                                              java.util.function.IntPredicate predicate)

Filters an array of ints, based a predicate, into a set.

Parameters:

ints - An array of ints to be filtered.

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

Returns:

A Set of Integer objects filtered from an array of int.

intFilterDistinct

public static int[] intFilterDistinct(int[] ints,
                                      java.util.function.IntPredicate predicate)

Filters an array of ints, based a predicate, into an array of distinct int values (according to Integer.compare(int, int)).

Parameters:

ints - An array of ints to be filtered.

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

Returns:

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

intFilter

public static <C extends java.util.Collection<java.lang.Integer>> C intFilter(int[] ints,
                                                                              org.perro.functions.predicate.IntFilterCollector<C> filterCollector)

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

     int[] ints = ...
     List<Integer> = IntFilterUtils.intFilter(ints, FilterUtils.intFilterAndThen(IntPredicateUtils.intGt(1.0D), Collectors.toCollection(LinkedList::new)));
 

Or, with static imports:

     intFilter(ints, intFilterAndThen(intGt(1.0D), toCollection(LinkedList::new)));
 

Type Parameters:

C - The type of the resulting Collection.

Parameters:

ints - An array of ints to be filtered.

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

Returns:

A Collection of Integer objects filtered from an array of int.

intFilterDistinct

public static <C extends java.util.Collection<java.lang.Integer>> C intFilterDistinct(int[] ints,
                                                                                      org.perro.functions.predicate.IntFilterCollector<C> filterCollector)

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

     int[] ints = ...
     List<Integer> = IntFilterUtils.intFilter(ints, IntFilterUtils.intFilterAndThen(IntPredicateUtils.intGt(1), Collectors.toCollection(LinkedList::new)));
 

Or, with static imports:

     List<Integer> = intFilter(ints, intFilterAndThen(intGt(1), toCollection(LinkedList::new)));
 

Type Parameters:

C - The type of the resulting Collection.

Parameters:

ints - An array of ints to be filtered.

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

Returns:

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

intFilterAndThen

public static <C extends java.util.Collection<java.lang.Integer>> org.perro.functions.predicate.IntFilterCollector<C> intFilterAndThen(java.util.function.IntPredicate filter,
                                                                                                                                       java.util.stream.Collector<java.lang.Integer,?,C> collector)

Builds an object combining a IntPredicate and a Collector for use in the intFilter(int[], IntFilterCollector) method.

Type Parameters:

C - The type of the resulting collection.

Parameters:

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

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

Returns:

A Collection of Integer containing objects filtered from an array of int.