java8.util.function

Class Predicates

java.lang.Object

java8.util.function.Predicates

public final class Predicates
extends java.lang.Object

A place for static default implementations of the new Java 8 default interface methods and static interface methods in the Predicate interface.

Method Summary

Modifier and Type	Method and Description
static <T> Predicate<T>	and(Predicate<? super T> this_, Predicate<? super T> other) Returns a composed predicate that represents a short-circuiting logical AND of the this_ predicate and another.
static <T> Predicate<T>	isEqual(java.lang.Object targetRef) Returns a predicate that tests if two arguments are equal according to Objects.equals(Object, Object).
static <T> Predicate<T>	negate(Predicate<? super T> this_) Returns a predicate that represents the logical negation of the this_ predicate.
static <T> Predicate<T>	or(Predicate<? super T> this_, Predicate<? super T> other) Returns a composed predicate that represents a short-circuiting logical OR of the this_ predicate and another.

Methods inherited from class java.lang.Object

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

Method Detail

and

public static <T> Predicate<T> and(Predicate<? super T> this_,
                                   Predicate<? super T> other)

Returns a composed predicate that represents a short-circuiting logical AND of the this_ predicate and another. When evaluating the composed predicate, if the this_ predicate is false, then the other predicate is not evaluated.

Any exceptions thrown during evaluation of either predicate are relayed to the caller; if evaluation of the this_ predicate throws an exception, the other predicate will not be evaluated.

Type Parameters:

T - the type of the input to the predicates

Parameters:

this_ - a predicate that will be logically-ANDed with the other predicate

other - a predicate that will be logically-ANDed with the this_ predicate

Returns:

a composed predicate that represents the short-circuiting logical AND of the this_ predicate and the other predicate

Throws:

java.lang.NullPointerException - if this_ is null

java.lang.NullPointerException - if other is null

negate

public static <T> Predicate<T> negate(Predicate<? super T> this_)

Returns a predicate that represents the logical negation of the this_ predicate.

Type Parameters:

T - the type of the input to the predicate

Parameters:

this_ - the predicate to be negated

Returns:

a predicate that represents the logical negation of the this_ predicate

Throws:

java.lang.NullPointerException - if this_ is null

or

public static <T> Predicate<T> or(Predicate<? super T> this_,
                                  Predicate<? super T> other)

Returns a composed predicate that represents a short-circuiting logical OR of the this_ predicate and another. When evaluating the composed predicate, if the this_ predicate is true, then the other predicate is not evaluated.

Any exceptions thrown during evaluation of either predicate are relayed to the caller; if evaluation of the this_ predicate throws an exception, the other predicate will not be evaluated.

Type Parameters:

T - the type of the input to the predicates

Parameters:

this_ - a predicate that will be logically-ORed with the other predicate

other - a predicate that will be logically-ORed with the this_ predicate

Returns:

a composed predicate that represents the short-circuiting logical OR of the this_ predicate and the other predicate

Throws:

java.lang.NullPointerException - if this_ is null

java.lang.NullPointerException - if other is null

isEqual

public static <T> Predicate<T> isEqual(java.lang.Object targetRef)

Returns a predicate that tests if two arguments are equal according to Objects.equals(Object, Object).

Type Parameters:

T - the type of arguments to the predicate

Parameters:

targetRef - the object reference with which to compare for equality, which may be null

Returns:

a predicate that tests if two arguments are equal according to Objects.equals(Object, Object)