T1
- argument 1 of the functionT2
- argument 2 of the functionR
- return type of the function@FunctionalInterface public interface CheckedFunction2<T1,T2,R> extends λ<R>
λ.Memoized
Modifier and Type | Field and Description |
---|---|
static long |
serialVersionUID
The serial version uid.
|
Modifier and Type | Method and Description |
---|---|
default <V> CheckedFunction2<T1,T2,V> |
andThen(CheckedFunction1<? super R,? extends V> after)
Returns a composed function that first applies this CheckedFunction2 to the given argument and then applies
CheckedFunction1
after to the result. |
default CheckedFunction1<T2,R> |
apply(T1 t1)
Applies this function partially to one argument.
|
R |
apply(T1 t1,
T2 t2)
Applies this function to two arguments and returns the result.
|
default int |
arity() |
static <T1,T2,R> CheckedFunction2<T1,T2,R> |
constant(R value)
Returns a function that always returns the constant
value that you give in parameter.
|
default Function1<T1,CheckedFunction1<T2,R>> |
curried()
Returns a curried version of this function.
|
static <T1,T2,R> Function2<T1,T2,Option<R>> |
lift(CheckedFunction2<? super T1,? super T2,? extends R> partialFunction)
Lifts the given
partialFunction into a total function that returns an Option result. |
static <T1,T2,R> Function2<T1,T2,Try<R>> |
liftTry(CheckedFunction2<? super T1,? super T2,? extends R> partialFunction)
Lifts the given
partialFunction into a total function that returns an Try result. |
default CheckedFunction2<T1,T2,R> |
memoized()
Returns a memoizing version of this function, which computes the return value for given arguments only one time.
|
static <T1,T2,R> CheckedFunction2<T1,T2,R> |
of(CheckedFunction2<T1,T2,R> methodReference)
|
default Function2<T1,T2,R> |
recover(Function<? super Throwable,? extends BiFunction<? super T1,? super T2,? extends R>> recover)
Return a composed function that first applies this CheckedFunction2 to the given arguments and in case of throwable
try to get value from
recover function with same arguments and throwable information. |
default CheckedFunction2<T2,T1,R> |
reversed()
Returns a reversed version of this function.
|
default CheckedFunction1<Tuple2<T1,T2>,R> |
tupled()
Returns a tupled version of this function.
|
default Function2<T1,T2,R> |
unchecked()
Return unchecked function that will return this CheckedFunction2 result in correct case and throw exception
wrapped by
IllegalStateException in case of throwable. |
default Function2<T1,T2,R> |
unchecked(Function<? super Throwable,? extends RuntimeException> exceptionMapper)
Return unchecked function that will return this CheckedFunction2 result in correct case and throw runtime exception
wrapped by
exceptionMapper in case of throwable |
isMemoized
static final long serialVersionUID
static <T1,T2,R> CheckedFunction2<T1,T2,R> of(CheckedFunction2<T1,T2,R> methodReference)
CheckedFunction2
based on
Examples (w.l.o.g. referring to Function1):
// using a lambda expression
Function1<Integer, Integer> add1 = Function1.of(i -> i + 1);
// using a method reference (, e.g. Integer method(Integer i) { return i + 1; })
Function1<Integer, Integer> add2 = Function1.of(this::method);
// using a lambda reference
Function1<Integer, Integer> add3 = Function1.of(add1::apply);
Caution: Reflection loses type information of lambda references.
// type of a lambda expression
Type<?, ?> type1 = add1.getType(); // (Integer) -> Integer
// type of a method reference
Type<?, ?> type2 = add2.getType(); // (Integer) -> Integer
// type of a lambda reference
Type<?, ?> type3 = add3.getType(); // (Object) -> Object
R
- return typeT1
- 1st argumentT2
- 2nd argumentmethodReference
- (typically) a method reference, e.g. Type::method
CheckedFunction2
static <T1,T2,R> Function2<T1,T2,Option<R>> lift(CheckedFunction2<? super T1,? super T2,? extends R> partialFunction)
partialFunction
into a total function that returns an Option
result.R
- return typeT1
- 1st argumentT2
- 2nd argumentpartialFunction
- a function that is not defined for all values of the domain (e.g. by throwing)partialFunction
and returns Some(result)
if the function is defined for the given arguments, and None
otherwise.static <T1,T2,R> Function2<T1,T2,Try<R>> liftTry(CheckedFunction2<? super T1,? super T2,? extends R> partialFunction)
partialFunction
into a total function that returns an Try
result.R
- return typeT1
- 1st argumentT2
- 2nd argumentpartialFunction
- a function that is not defined for all values of the domain (e.g. by throwing)partialFunction
and returns Success(result)
if the function is defined for the given arguments, and Failure(throwable)
otherwise.R apply(T1 t1, T2 t2) throws Throwable
t1
- argument 1t2
- argument 2Throwable
- if something goes wrong applying this function to the given argumentsdefault CheckedFunction1<T2,R> apply(T1 t1)
t1
- argument 1default int arity()
static <T1,T2,R> CheckedFunction2<T1,T2,R> constant(R value)
T1
- generic parameter type 1 of the resulting functionT2
- generic parameter type 2 of the resulting functionR
- the result typevalue
- the value to be returneddefault Function1<T1,CheckedFunction1<T2,R>> curried()
λ
default CheckedFunction1<Tuple2<T1,T2>,R> tupled()
λ
default CheckedFunction2<T2,T1,R> reversed()
λ
default CheckedFunction2<T1,T2,R> memoized()
λ
Please note that memoizing functions do not permit null
as single argument or return value.
default Function2<T1,T2,R> recover(Function<? super Throwable,? extends BiFunction<? super T1,? super T2,? extends R>> recover)
recover
function with same arguments and throwable information.recover
- the function applied in case of throwableNullPointerException
- if recover is nulldefault Function2<T1,T2,R> unchecked(Function<? super Throwable,? extends RuntimeException> exceptionMapper)
exceptionMapper
in case of throwableexceptionMapper
- the function that convert function Throwable
into subclass of RuntimeException
RuntimeException
issued by the given exceptionMapper
in the case of a failuredefault Function2<T1,T2,R> unchecked()
IllegalStateException
in case of throwable.IllegalStateException
in the case of a failuredefault <V> CheckedFunction2<T1,T2,V> andThen(CheckedFunction1<? super R,? extends V> after)
after
to the result.V
- return type of afterafter
- the function applied after thisNullPointerException
- if after is nullCopyright © 2016. All Rights Reserved.