Module java.base

Package java.util.function

Interface Predicate<T>

类型参数:

T - 断言的输入类型

函数式接口:

这是一个函数式接口，因此可以用作lambda表达式或方法引用的赋值目标。

       @FunctionalInterface public interface Predicate<T>
      

表示具有一个参数的断言（布尔值函数）。

这是一个函数式接口，其功能方法是test(Object)。

自 JDK 版本:

1.8

Method Summary

Modifier and Type	Method	Description
default Predicate<T>	and(Predicate<? super T> other)	返回一个组合的断言，表示此断言和另一个的短路逻辑与。
static <T> Predicate<T>	isEqual(Object targetRef)	返回一个断言，根据Objects.equals(Object, Object)测试两个参数是否相等。
default Predicate<T>	negate()	返回表示此断言的逻辑否定的断言。
static <T> Predicate<T>	not(Predicate<? super T> target)	返回所提供断言的否定。
default Predicate<T>	or(Predicate<? super T> other)	返回一个组合的断言，表示此断言和另一个的短路逻辑或。
boolean	test(T t)	在给定参数上评估此断言。

Method Details

test

             boolean test(T t)
            

在给定参数上评估此断言。

参数:

t - 输入参数

返回:

如果输入参数与断言匹配，则为true，否则为false

and

             default Predicate<T> and(Predicate<? super T> other)
            

返回一个组合的断言，表示此断言和另一个的短路逻辑与。在评估组合的断言时，如果此断言为false，则不会评估other断言。

在评估任一断言时抛出的任何异常都将传递给调用者；如果评估此断言引发异常，则不会评估other断言。

参数:

other - 将与此断言逻辑与的断言

返回:

一个组合的断言，表示此断言和other断言的短路逻辑与

抛出:

NullPointerException - 如果other为null

negate

             default Predicate<T> negate()
            

返回表示此断言的逻辑否定的断言。

返回:

一个表示此断言的逻辑否定的断言

or

             default Predicate<T> or(Predicate<? super T> other)
            

返回一个组合的断言，表示此断言和另一个的短路逻辑或。在评估组合的断言时，如果此断言为true，则不会评估other断言。

在评估任一断言时抛出的任何异常都将传递给调用者；如果评估此断言引发异常，则不会评估other断言。

参数:

other - 将与此断言逻辑或的断言

返回:

一个组合的断言，表示此断言和other断言的短路逻辑或

抛出:

NullPointerException - 如果other为null

isEqual

             static <T> Predicate<T> isEqual(Object targetRef)
            

返回一个断言，根据Objects.equals(Object, Object)测试两个参数是否相等。

类型参数:

T - 断言的参数类型

参数:

targetRef - 用于比较相等性的对象引用，可能为null

返回:

一个断言，根据Objects.equals(Object, Object)测试两个参数是否相等

not

             static <T> Predicate<T> not(Predicate<? super T> target)
            

返回所提供断言的否定。这是通过返回调用target.negate()的结果来实现的。

类型参数:

T - 指定断言的参数类型

参数:

target - 要否定的断言

返回:

一个否定所提供断言结果的断言

抛出:

NullPointerException - 如果target为null

自 JDK 版本:

11