- Type Parameters:
A- The type of the first input-parameter.
B- The type of the second input-parameter.
C- The type of the last input-parameter.
R- The type of the function-output.
- 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 TriFunction<A,B,C,R>Function-Pointer Input:
A, B, COutput:
This is an extension of Java's original functional-interfaces package. This
Functional Interfacedesigned here creates a "Tri Function" - a straight-forward extension of
interface java.util.function.Function- but instead has an
'apply(...)'method receiving three variable-type parameters instead of just one.
NOTE: Java's Basic Package
java.util.function.*, contains an
BiFunction, that extends the basic
interface BiFunction<T, U>. The
interfacethat is implemented here follows a similar vein, but extends the number of generic type-parameters to three, instead of two.
ALSO: Here, the number of return type-parameters (obviously) is still just one - since only one return value is possible, in Java.
'this'function to the given arguments.
a- the first input argument
b- the second input argument
c- the third input argument
- The result of the function. Return result is of type
default <V> TriFunction<A,B,C,V> andThen (java.util.function.Function<? super R,? extends V> after)Returns a composed function that first applies
'this'function to its input, and then applies the
'after'function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.
after- The function to apply after
'this'function is applied. This must be a simple, or single-argument function that has a variable-type parameter
'X'- or rather, the same-type as the output-type of
'this'(which, again, is
'X'- and pleaselook at the top of this page to see that
'X'is, indeed, the output type of
NOTE: The composed function that is returned will, itself, have an
apply(...)method with variable-parameter return type
- a composed
'TriFunction', that first applies
'this'function, and then applies the
java.lang.NullPointerException- This is thrown if
- Exact Method Body:
if (after == null) throw new NullPointerException("parameter 'after' has been passed null."); return (A a, B b, C c) -> after.apply(this.apply(a, b, c));