Module com.github.robtimus.function.throwing
Package com.github.robtimus.function.throwing

Interface ThrowingDoubleToIntFunction<X extends Throwable>

  • Type Parameters:
    X - The type of checked exception that can be thrown.
    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 ThrowingDoubleToIntFunction<X extends Throwable>
    Represents a function that accepts a double-valued argument and produces an int-valued result. This is a checked-exception throwing equivalent of DoubleToIntFunction.

    • Method Detail

      • applyAsInt

        int applyAsInt​(double value)
        throws X extends Throwable
        Applies this function to the given argument.
        Parameters:
        value - The function argument.
        Returns:
        The function result.
        Throws:
        X - If an error occurs.
        X extends Throwable

      • onErrorThrowAsChecked

        default <E extends Throwable> ThrowingDoubleToIntFunction<E> onErrorThrowAsChecked​(Function<? super X,​? extends E> errorMapper)
        Returns a function that applies this function to its input. Any checked exception thrown by this function is transformed using the given error mapper, and the returned function throws the transformation result.
        Type Parameters:
        E - The type of checked exception to transform to.
        Parameters:
        errorMapper - The function to use to transform any checked exception thrown by this function.
        Returns:
        A function that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorMapper is null.

      • onErrorThrowAsUnchecked

        default <E extends RuntimeException> DoubleToIntFunction onErrorThrowAsUnchecked​(Function<? super X,​? extends E> errorMapper)
        Returns a function that applies this function to its input. Any checked exception thrown by this function is transformed using the given error mapper, and the returned function throws the transformation result.
        Type Parameters:
        E - The type of unchecked exception to transform to.
        Parameters:
        errorMapper - The function to use to transform any checked exception thrown by this function.
        Returns:
        A function that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorMapper is null.

      • onErrorHandleChecked

        default <E extends Throwable> ThrowingDoubleToIntFunction<E> onErrorHandleChecked​(ThrowingToIntFunction<? super X,​? extends E> errorHandler)
        Returns a function that applies this function to its input. Any checked exception thrown by this function is transformed using the given error handler, and the returned function returns the transformation result.
        Type Parameters:
        E - The type of checked exception that can be thrown by the given error handler.
        Parameters:
        errorHandler - The function to use to transform any checked exception thrown by this function.
        Returns:
        A function that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorHandler is null.

      • onErrorHandleUnchecked

        default DoubleToIntFunction onErrorHandleUnchecked​(ToIntFunction<? super X> errorHandler)
        Returns a function that applies this function to its input. Any checked exception thrown by this function is transformed using the given error handler, and the returned function returns the transformation result.
        Parameters:
        errorHandler - The function to use to transform any checked exception thrown by this function.
        Returns:
        A function that transforms any thrown checked exception.
        Throws:
        NullPointerException - If errorHandler is null.

      • onErrorApplyChecked

        default <E extends Throwable> ThrowingDoubleToIntFunction<E> onErrorApplyChecked​(ThrowingDoubleToIntFunction<? extends E> fallback)
        Returns a function that applies this function to its input. If this function throws any checked exception, it is discarded and the given fallback function is invoked.
        Type Parameters:
        E - The type of checked exception that can be thrown by the given fallback function.
        Parameters:
        fallback - The function to invoke if this function throws any checked exception.
        Returns:
        A function that invokes the fallback function if this function throws any checked exception.
        Throws:
        NullPointerException - If fallback is null.

      • onErrorApplyUnchecked

        default DoubleToIntFunction onErrorApplyUnchecked​(DoubleToIntFunction fallback)
        Returns a function that applies this function to its input. If this function throws any checked exception, it is discarded and the given fallback function is invoked.
        Parameters:
        fallback - The function to invoke if this function throws any checked exception.
        Returns:
        A function that invokes the fallback function if this function throws any checked exception.
        Throws:
        NullPointerException - If fallback is null.

      • onErrorGetChecked

        default <E extends Throwable> ThrowingDoubleToIntFunction<E> onErrorGetChecked​(ThrowingIntSupplier<? extends E> fallback)
        Returns a function that applies this function to its input. If this function throws any checked exception, it is discarded and the given fallback supplier is invoked.
        Type Parameters:
        E - The type of checked exception that can be thrown by the given fallback supplier.
        Parameters:
        fallback - The supplier to produce the value to return if this function throws any checked exception.
        Returns:
        A function that invokes the fallback supplier if this function throws any checked exception.
        Throws:
        NullPointerException - If fallback is null.

      • onErrorGetUnchecked

        default DoubleToIntFunction onErrorGetUnchecked​(IntSupplier fallback)
        Returns a function that applies this function to its input. If this function throws any checked exception, it is discarded and the given fallback supplier is invoked.
        Parameters:
        fallback - The supplier to produce the value to return if this function throws any checked exception.
        Returns:
        A function that invokes the fallback supplier if this function throws any checked exception.
        Throws:
        NullPointerException - If fallback is null.

      • onErrorReturn

        default DoubleToIntFunction onErrorReturn​(int fallback)
        Returns a function that applies this function to its input. If this function throws any checked exception, it is discarded and the given fallback value is returned.
        Parameters:
        fallback - The value to return if this function throws any checked exception.
        Returns:
        A function that returns the fallback value if this function throws any checked exception.

      • of

        static <X extends Throwable> ThrowingDoubleToIntFunction<X> of​(ThrowingDoubleToIntFunction<X> function)
        Factory method for turning ThrowingDoubleToIntFunction-shaped lambdas into ThrowingDoubleToIntFunctions.
        Type Parameters:
        X - The type of checked exception that can be thrown.
        Parameters:
        function - The lambda to return as ThrowingDoubleToIntFunction.
        Returns:
        The given lambda as a ThrowingDoubleToIntFunction.
        Throws:
        NullPointerException - If function is null.

      • checked

        static <X extends Throwable> ThrowingDoubleToIntFunction<X> checked​(DoubleToIntFunction function)
        Returns a function that applies the function function to its input. Any unchecked exception thrown by the function function is relayed to the caller. This method allows existing DoubleToIntFunction instances to be used where ThrowingDoubleToIntFunction is expected.
        Type Parameters:
        X - The type of checked exception that can be thrown.
        Parameters:
        function - The function to apply when the returned function is applied.
        Returns:
        A function that wraps any checked exception in an UncheckedException.
        Throws:
        NullPointerException - If function is null.

      • checked

        static <X extends Throwable> ThrowingDoubleToIntFunction<X> checked​(DoubleToIntFunction function,
                                                                    Class<X> errorType)
        Returns a function that applies the function function to its input. Any UncheckedException thrown by the function function is unwrapped if its cause is an instance of errorType, otherwise it is relayed to the caller.
        Type Parameters:
        X - The type of checked exception that can be thrown.
        Parameters:
        function - The function to apply when the returned function is applied.
        errorType - The type of checked exception that can be thrown.
        Returns:
        A function that wraps any checked exception in an UncheckedException.
        Throws:
        NullPointerException - If function or errorType is null.