Interface QuintFunction<A,​B,​C,​D,​E,​X>


  • public interface QuintFunction<A,​B,​C,​D,​E,​X>
    QuintFunction Documentation.

    This is an extension of Java's original functional-interfaces package. This Functional Interface designed here creates a "Quint Function" - a straight-forward extension of interface java.util.function.Function - but instead has an 'apply(...)' method receiving five variable-type parameters instead of just one.

    NOTE: Java's Basic Package java.util.function.*, contains an interface named BiFunction, that extends the basic Function<T> to interface BiFunction<T, U>. The interface that is implemented here follows a similar vein, but extends the number of generic type-parameters to five, 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.



    • Method Detail

      • apply

        X apply​(A a,
                B b,
                C c,
                D d,
                E e)
        Applies 'this' function to the given arguments.
        Parameters:
        a - the first input argument
        b - the second input argument
        c - the third input argument
        d - the fourth input argument
        e - the fifth input argument
        Returns:
        The result of the function. Return result is of type 'X'
      • andThen

        default <V> QuintFunction<A,​B,​C,​D,​E,​V> andThen​
                    (java.util.function.Function<? super X,​? 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.
        Parameters:
        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 'this' apply(...) method).

        NOTE: The composed function that is returned will, itself, have an apply(...) method with variable-parameter return type 'V'.
        Returns:
        a composed 'QuintFunction', that first applies 'this' function, and then applies the 'after' function.
        Throws:
        java.lang.NullPointerException - This is thrown if 'after' is null.
        Code:
        Exact Method Body:
        1
        2
        3
        4
         if (after == null)
             throw new NullPointerException("parameter 'after' has been passed null.");
        
         return (A a, B b, C c, D d, E e) -> after.apply(this.apply(a, b, c, d, e));