Package nbbrd.io.function

Interface IOPredicate<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 IOPredicate<T>

Represents a predicate (boolean-valued function) of one argument.

Method Summary

Modifier and Type	Method	Description
default @NonNull IOPredicate<T>	and(@NonNull IOPredicate<? super T> other)	Returns a composed predicate that represents a short-circuiting logical AND of this predicate and another.
default @NonNull Predicate<T>	asUnchecked()
static <T> @NonNull IOPredicate<T>	checked(@NonNull Predicate<T> predicate)
static <T> @NonNull IOPredicate<T>	isEqual(Object targetRef)	Returns a predicate that tests if two arguments are equal according to Objects.equals(Object, Object).
default @NonNull IOPredicate<T>	negate()	Returns a predicate that represents the logical negation of this predicate.
static <T> @NonNull IOPredicate<T>	of(boolean r)
default @NonNull IOPredicate<T>	or(@NonNull IOPredicate<? super T> other)	Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another.
boolean	testWithIO(T t)	Evaluates this predicate on the given argument.
static <T> @NonNull Predicate<T>	unchecked(@NonNull IOPredicate<T> o)

Method Detail

testWithIO

@JdkWithIO
boolean testWithIO(T t)
            throws IOException

Evaluates this predicate on the given argument.

Parameters:

t - the input argument

Returns:

true if the input argument matches the predicate, otherwise false

Throws:

IOException - if an I/O error occurs

and

@JdkWithIO
default @NonNull IOPredicate<T> and(@NonNull IOPredicate<? 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

@JdkWithIO
default @NonNull IOPredicate<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

@JdkWithIO
default @NonNull IOPredicate<T> or(@NonNull IOPredicate<? 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

asUnchecked

default @NonNull Predicate<T> asUnchecked()

unchecked

static <T> @NonNull Predicate<T> unchecked(@NonNull IOPredicate<T> o)

checked

static <T> @NonNull IOPredicate<T> checked(@NonNull Predicate<T> predicate)

isEqual

@JdkWithIO
static <T> @NonNull IOPredicate<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)

of

static <T> @NonNull IOPredicate<T> of(boolean r)