Interface Predicate<T>
-
- 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.
@FunctionalInterface public interface Predicate<T>
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
All Methods Static Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method and Description default Predicate<T>and(Predicate<? super T> other)Returns a composed predicate that represents a short-circuiting logical AND of this predicate and another.static <T> Predicate<T>isEqual(Object targetRef)Returns a predicate that tests if two arguments are equal according toObjects.equals(Object, Object).default Predicate<T>negate()Returns a predicate that represents the logical negation of this predicate.default Predicate<T>or(Predicate<? super T> other)Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another.booleantest(T t)Evaluates this predicate on the given argument.
-
-
-
Method Detail
test
boolean test(T t)
Evaluates this predicate on the given argument.- Parameters:
-
t- the input argument - Returns:
-
trueif the input argument matches the predicate, otherwisefalse
and
default Predicate<T> and(Predicate<? super T> other)
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
default Predicate<T> negate()
Returns a predicate that represents the logical negation of this predicate.- Returns:
- a predicate that represents the logical negation of this predicate
or
default Predicate<T> or(Predicate<? super T> other)
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
static <T> Predicate<T> isEqual(Object targetRef)
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)
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
