com.github.tonivade.purefun.Function3 Maven / Gradle / Ivy

Go to download
/*
 * Copyright (c) 2018-2021, Antonio Gabriel Muñoz Conejo 
 * Distributed under the terms of the MIT License
 */
package com.github.tonivade.purefun;

/**
 * This interface represents a function with a three parameters. There's no equivalence in the JVM.
 * The function can throws checked exceptions, but calling {@code apply()} method, the exception is sneaky thrown. So, it
 * can be used as a higher order function in {@link java.util.stream.Stream} or {@link java.util.Optional} API.
 * @param  type of first function parameter
 * @param  type of second function parameter
 * @param  type of third function parameter
 * @param  type of return value
 */
@FunctionalInterface
public interface Function3 extends Recoverable {

  default R apply(A a, B b, C c) {
    try {
      return run(a, b, c);
    } catch (Throwable t) {
      return sneakyThrow(t);
    }
  }

  R run(A a, B b, C c) throws Throwable;

  default Function1>> curried() {
    return a -> b -> c -> apply(a, b, c);
  }

  default Function1, R> tupled() {
    return tuple -> apply(tuple.get1(), tuple.get2(), tuple.get3());
  }

  default  Function3 andThen(Function1 after) {
    return (a, b, c) -> after.apply(apply(a, b, c));
  }

  default  Function1 compose(Function1 beforeT1, Function1 beforeT2, Function1 beforeT3) {
    return value -> apply(beforeT1.apply(value), beforeT2.apply(value), beforeT3.apply(value));
  }

  default Function3 memoized() {
    return (a, b, c) -> new MemoizedFunction<>(tupled()).apply(Tuple.of(a, b, c));
  }

  static  Function3 cons(R value) {
    return (a, b, c) -> value;
  }
}