Module java.base
Package java.util.function

# Interface BiPredicate<T,U>

Type Parameters:
  `T` - the type of the first argument to the predicate
  `U` - the type of the second argument 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 BiPredicate<T,U>
Represents a predicate (boolean-valued function) of two arguments. This is the two-arity specialization of `Predicate`.

This is a functional interface whose functional method is `test(Object, Object)`.

Since:
  1.8
See Also:
  - `Predicate`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `default BiPredicate<T,U>`
  `and(BiPredicate<? super T,? super U> other)`
  Returns a composed predicate that represents a short-circuiting logical AND of this predicate and another.
  `default BiPredicate<T,U>`
  `negate()`
  Returns a predicate that represents the logical negation of this predicate.
  `default BiPredicate<T,U>`
  `or(BiPredicate<? super T,? super U> other)`
  Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another.
  `boolean`
  `test(T t, U u)`
  Evaluates this predicate on the given arguments.

- ## Method Details

  - ### test

    boolean test(T t, U u)
    Evaluates this predicate on the given arguments.
    Parameters:
      `t` - the first input argument
      `u` - the second input argument
    Returns:
      `true` if the input arguments match the predicate, otherwise `false`

  - ### and

    default BiPredicate<T,U> and(BiPredicate<? super T,? super U> 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 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 this predicate throws an exception, the `other` predicate 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 `other` predicate
    Throws:
      `NullPointerException` - if other is null

  - ### negate

    default BiPredicate<T,U> 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 BiPredicate<T,U> or(BiPredicate<? super T,? super U> 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 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 this predicate throws an exception, the `other` predicate 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 `other` predicate
    Throws:
      `NullPointerException` - if other is null