org.apache.commons.collections4.functors

Class AnyPredicate<T>

java.lang.Object

org.apache.commons.collections4.functors.AbstractQuantifierPredicate<T>

org.apache.commons.collections4.functors.AnyPredicate<T>

All Implemented Interfaces:

java.io.Serializable, PredicateDecorator<T>, Predicate<T>

public final class AnyPredicate<T>
extends AbstractQuantifierPredicate<T>

Predicate implementation that returns true if any of the predicates return true. If the array of predicates is empty, then this predicate returns false.

NOTE: In versions prior to 3.2 an array size of zero or one threw an exception.

Since:

3.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AnyPredicate(Predicate<? super T>... predicates) Constructor that performs no validation.

Method Summary

Modifier and Type	Method and Description
static <T> Predicate<T>	anyPredicate(java.util.Collection<? extends Predicate<? super T>> predicates) Factory to create the predicate.
static <T> Predicate<T>	anyPredicate(Predicate<? super T>... predicates) Factory to create the predicate.
boolean	evaluate(T object) Evaluates the predicate returning true if any predicate returns true.

Methods inherited from class org.apache.commons.collections4.functors.AbstractQuantifierPredicate

getPredicates

Methods inherited from class java.lang.Object

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

Constructor Detail

AnyPredicate

public AnyPredicate(Predicate<? super T>... predicates)

Constructor that performs no validation. Use anyPredicate if you want that.

Parameters:

predicates - the predicates to check, not cloned, not null

Method Detail

anyPredicate

public static <T> Predicate<T> anyPredicate(Predicate<? super T>... predicates)

Factory to create the predicate.

If the array is size zero, the predicate always returns false. If the array is size one, then that predicate is returned.

Type Parameters:

T - the type that the predicate queries

Parameters:

predicates - the predicates to check, cloned, not null

Returns:

the any predicate

Throws:

java.lang.NullPointerException - if the predicates array is null

java.lang.NullPointerException - if any predicate in the array is null

anyPredicate

public static <T> Predicate<T> anyPredicate(java.util.Collection<? extends Predicate<? super T>> predicates)

Factory to create the predicate.

If the collection is size zero, the predicate always returns false. If the collection is size one, then that predicate is returned.

Type Parameters:

T - the type that the predicate queries

Parameters:

predicates - the predicates to check, cloned, not null

Returns:

the all predicate

Throws:

java.lang.NullPointerException - if the predicates array is null

java.lang.NullPointerException - if any predicate in the array is null

evaluate

public boolean evaluate(T object)

Evaluates the predicate returning true if any predicate returns true.

Parameters:

object - the input object

Returns:

true if any decorated predicate return true