Package org.apache.commons.collections4.functors

Class AnyPredicate<T>

java.lang.Object
org.apache.commons.collections4.functors.AbstractPredicate<T>
org.apache.commons.collections4.functors.AbstractQuantifierPredicate<T>
org.apache.commons.collections4.functors.AnyPredicate<T>
Type Parameters:
T - the type of the input to the predicate.
All Implemented Interfaces:
Serializable, Predicate<T>, 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:

  • Constructor Details

    • 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 Details

    • anyPredicate

      public static <T> Predicate<T> anyPredicate(Collection<? extends Predicate<? super T>> predicates)
      Creates 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:
      NullPointerException - if the predicates array is null
      NullPointerException - if any predicate in the array is null

    • anyPredicate

      public static <T> Predicate<T> anyPredicate(Predicate<? super T>... predicates)
      Creates 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:
      NullPointerException - if the predicates array is null
      NullPointerException - if any predicate in the array is null

    • test

      public boolean test(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