OptionalPredicate (NoException 1.6.1 API)

Type Parameters:

T - see 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 OptionalPredicate<T>
```
Variation of Predicate that returns OptionalBoolean instead of the raw value. OptionalPredicate is typically obtained from ExceptionHandler.predicate(Predicate), in which case its return value is empty when the underlying Predicate throws an exception. See noexception tutorial.

See Also:

ExceptionHandler.predicate(Predicate), Predicate

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default Predicate<T>`	`orElse(boolean result)` Converts this `OptionalPredicate` to plain `Predicate` using default value.
`default Predicate<T>`	`orElseGet(BooleanSupplier source)` Converts this `OptionalPredicate` to plain `Predicate` using fallback `BooleanSupplier`.
`OptionalBoolean`	`test(T t)` Variation of `Predicate.test(Object)` that returns `OptionalBoolean`.

- Method Detail
  - test
```
OptionalBoolean test(T t)
```
    Variation of Predicate.test(Object) that returns OptionalBoolean. If this OptionalPredicate is obtained from ExceptionHandler.predicate(Predicate), the OptionalBoolean will be empty only if the underlying Predicate throws. Otherwise the returned OptionalBoolean just wraps the return value of underlying Predicate.
    
    Parameters:
    
    t - see Predicate.test(Object)
    
    Returns:
    
    OptionalBoolean typically wrapping return value of Predicate.test(Object), or an empty OptionalBoolean (typically signifying an exception)
    
    See Also:
    
    ExceptionHandler.predicate(Predicate), Predicate.test(Object)
  - orElse
```
default Predicate<T> orElse(boolean result)
```
    Converts this OptionalPredicate to plain Predicate using default value. The returned Predicate will unwrap present value from the OptionalBoolean if possible, or return result if the OptionalBoolean is empty.
    
    Parameters:
    
    result - default value to return instead of an empty OptionalBoolean
    
    Returns:
    
    plain Predicate that either unwraps OptionalBoolean or returns default value
    
    See Also:
    
    orElseGet(BooleanSupplier), OptionalBoolean.orElse(boolean)
  - orElseGet
```
default Predicate<T> orElseGet(BooleanSupplier source)
```
    Converts this OptionalPredicate to plain Predicate using fallback BooleanSupplier. The returned Predicate will unwrap present value from the OptionalBoolean if possible, or fall back to calling source if the OptionalBoolean is empty.
    
    Parameters:
    
    source - BooleanSupplier to query for fallback value when OptionalBoolean is empty
    
    Returns:
    
    plain Predicate that either unwraps OptionalBoolean or falls back to source
    
    See Also:
    
    orElse(boolean), OptionalBoolean.orElseGet(BooleanSupplier)

Interface OptionalPredicate<T>

Method Summary

Method Detail

test

orElse

orElseGet