java8 Predicate接口API翻译

java.util.function

Interface Predicate<T>

• 类型参数： T -谓词的输入类型

  功能接口：

  这是一个功能接口，因此可以用作lambda表达式或方法引用的赋值对象。

  ---

  
  

  @FunctionalInterface
  public interface Predicate<T>

  表示一个参数的谓词（布尔值函数）。

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

  从以下版本开始：

          1.8

• • 方法摘要：

    All MethodsStatic MethodsInstance MethodsAbstract MethodsDefault Methods

    修饰符和类型	方法和说明
    default Predicate<T>	and(Predicate<? super T> other) 返回一个组合的谓词，表示该谓词与另一个谓词的短路逻辑AND。
    static <T> Predicate<T>	isEqual(Object targetRef) 返回一个谓词，根据Objects.equals(Object，Object)测试两个参数是否相等。
    default Predicate<T>	negate() 返回表示此谓词的逻辑否定的谓词。
    default Predicate<T>	or(Predicate<? super T> other) 返回一个组合的谓词，表示该谓词与另一个谓词的短路逻辑或。
    boolean	test(T t) 在给定的参数上评估这个谓词。

• • 方法详细信息

    • test

      boolean test(T t)

      在给定的参数上评估这个谓词。

      参数：       t -输入参数

      返回：

        如果输入参数与谓词匹配，则为true，否则为false

    • and

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

      返回一个组合的谓词，表示该谓词与另一个谓词的短路逻辑AND。 当评估组合谓词时，如果此谓词为假，则不评估其他谓词。

      在评估任一谓词期间抛出的任何异常被转发到调用者; 如果此谓词的评估引发异常，则不会评估另一个谓词。

      参数：

              other- 将与此谓词进行逻辑与操作的谓词

      返回：

              一个组成的谓词，表示该谓词和另一个谓词的短路逻辑AND

      抛出：

              NullPointerException - 如果other为null

    • negate

      default Predicate<T> negate()

      返回表示此谓词的逻辑否定的谓词。

      返回：

              一个表示该谓词的逻辑否定的谓词

    • or

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

      返回一个组合的谓词，表示该谓词与另一个谓词的短路逻辑或。 当评估组合谓词时，如果此谓词为真，则不对其他谓词进行求值。

      在评估任一谓词期间抛出的任何异常被中继到调用者; 如果此谓词的评估引发异常，则不会评估另一个谓词。

      参数：

              other - 将与此谓词进行逻辑或运算的谓词

      返回：

              一个组成的谓词，表示该谓词和另一个谓词的短路逻辑或

      抛出：

              NullPointerException - 如果other为null

    • isEqual

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

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

      类型参数：

              T - 谓词的参数类型

      参数：

              targetRef - 与其进行比较的对象引用，可以为空

      返回：

              根据Objects.equals(Object，Object)测试两个参数是否相等的谓词

      来源： http://docs.oracle.com/javase/8/docs/api/java/util/function/Predicate.html