Package io.fluxcapacitor.common

Interface ThrowingPredicate<T>

public interface ThrowingPredicate<T>

  • Method Details

    • test

      boolean test(T t) throws Exception
      Evaluates this predicate on the given argument.
      Parameters:
      t - the input argument
      Returns:
      true if the input argument matches the predicate, otherwise false
      Throws:
      Exception

    • and

      default ThrowingPredicate<T> and(ThrowingPredicate<? 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 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 ThrowingPredicate<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 ThrowingPredicate<T> or(ThrowingPredicate<? 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 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

    • isEqual

      static <T> ThrowingPredicate<T> isEqual(Object targetRef)
      Returns a predicate that tests if two arguments are equal according to Objects.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 be null
      Returns:
      a predicate that tests if two arguments are equal according to Objects.equals(Object, Object)

    • not

      static <T> ThrowingPredicate<T> not(ThrowingPredicate<? super T> target)
      Returns a predicate that is the negation of the supplied predicate. This is accomplished by returning result of the calling target.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

    • asPredicate

      default Predicate<T> asPredicate()
      Converts this ThrowingPredicate into a standard Predicate. Any exceptions thrown during the evaluation of the predicate are wrapped and forcibly rethrown.
      Returns:
      a standard Predicate representation of this ThrowingPredicate