Package de.treestack.throwing

Interface Function<T,R,E extends Exception>

Type Parameters:
T - the type of the input to the function
R - the type of the result of the function
E - the type of the exception that may be thrown
All Known Subinterfaces:
UnaryOperator<T,E>
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 Function<T,R,E extends Exception>
Represents a function that accepts one argument, produces a result and (optionally) throws an Exception.

This is a functional interface whose functional method is apply(Object) )}.

Since:
1.0

  • Method Summary

    Modifier and Type
    Method
    Description
    R
    apply(T arg)
    Applies this function to the given argument.
    default Function<T,Optional<R>>
    lift()
    Lifts this function that may throw an exception into a function that returns an Optional.
    static <T, R> Function<T,Optional<R>>
    lifted(Function<? super T,? extends R,?> function)
    Lifts a function that may throw an exception into a function that returns an Optional.
    default Function<T,R>
    unchecked()
    Wraps this function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.
    static <T, R> Function<T,R>
    unchecked(Function<? super T,? extends R,?> function)
    Wraps a function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.

  • Method Details

    • apply

      R apply(T arg) throws E
      Applies this function to the given argument.
      Parameters:
      arg - the function argument
      Returns:
      the function result
      Throws:
      E - if an exception occurs
      Since:
      1.0

    • lifted

      static <T, R> Function<T,Optional<R>> lifted(Function<? super T,? extends R,?> function)
      Lifts a function that may throw an exception into a function that returns an Optional. If the original function throws an exception, the returned function will return an empty Optional. Otherwise, the returned function will return an Optional containing the result of the original function.
      Type Parameters:
      T - the type of the input to the function
      R - the type of the result of the function
      Parameters:
      function - the function to lift
      Returns:
      a function that returns an Optional
      Since:
      1.0

    • unchecked

      static <T, R> Function<T,R> unchecked(Function<? super T,? extends R,?> function)
      Wraps a function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.
      Type Parameters:
      T - the type of the input to the function
      R - the type of the result of the function
      Parameters:
      function - the function to wrap
      Returns:
      a function that will throw a RuntimeException if the original function throws an exception
      Since:
      1.0

    • lift

      default Function<T,Optional<R>> lift()
      Lifts this function that may throw an exception into a function that returns an Optional. If the original function throws an exception, the returned function will return an empty Optional. Otherwise, the returned function will return an Optional containing the result of the original function.
      Returns:
      a function that returns an Optional
      Since:
      1.0
      See Also:

    • unchecked

      default Function<T,R> unchecked()
      Wraps this function that may throw an exception into a function that will throw a RuntimeException if the original function throws an exception.
      Returns:
      a function that will throw a RuntimeException if the original function throws an exception
      Since:
      1.0
      See Also: