- Type Parameters:
T- the type of the input to the predicate
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
Represents a predicate (boolean-valued function) of one argument.
This is a functional interface
whose functional method is test(Object).
- Since:
- 1.8
-
Method Summary
Modifier and TypeMethodDescriptionReturns a composed predicate that represents a short-circuiting logical AND of this predicate and another.static <T> Predicate<T>Returns a predicate that tests if two arguments are equal according toObjects.equals(Object, Object).negate()Returns a predicate that represents the logical negation of this predicate.static <T> Predicate<T>Returns a predicate that is the negation of the supplied predicate.Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another.booleanEvaluates this predicate on the given argument.
-
Method Details
-
test
Evaluates this predicate on the given argument.- Parameters:
t- the input argument- Returns:
trueif the input argument matches the predicate, otherwisefalse
-
and
Returns a composed predicate that represents a short-circuiting logical AND of this predicate and another. When evaluating the composed predicate, if this predicate isfalse, then theotherpredicate is not evaluated.Any exceptions thrown during evaluation of either predicate are relayed to the caller; if evaluation of this predicate throws an exception, the
otherpredicate will not be evaluated.- Parameters:
other- a predicate that will be logically-ANDed with this predicate- Returns:
- a composed predicate that represents the short-circuiting logical
AND of this predicate and the
otherpredicate - Throws:
NullPointerException- if other is null
-
negate
Returns a predicate that represents the logical negation of this predicate.- Returns:
- a predicate that represents the logical negation of this predicate
-
or
Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another. When evaluating the composed predicate, if this predicate istrue, then theotherpredicate is not evaluated.Any exceptions thrown during evaluation of either predicate are relayed to the caller; if evaluation of this predicate throws an exception, the
otherpredicate will not be evaluated.- Parameters:
other- a predicate that will be logically-ORed with this predicate- Returns:
- a composed predicate that represents the short-circuiting logical
OR of this predicate and the
otherpredicate - Throws:
NullPointerException- if other is null
-
isEqual
Returns a predicate that tests if two arguments are equal according toObjects.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 benull- Returns:
- a predicate that tests if two arguments are equal according
to
Objects.equals(Object, Object)
-
not
Returns a predicate that is the negation of the supplied predicate. This is accomplished by returning result of the callingtarget.negate().- Type Parameters:
T- the type of arguments to the specified predicate- Parameters:
target- predicate to negate- Returns:
- a predicate that negates the results of the supplied predicate
- Throws:
NullPointerException- if target is null- Since:
- 11
-