package com.github.markozajc.ef.trifunction.except;

import static com.github.markozajc.ef.Utilities.asUnchecked;

import com.github.markozajc.ef.trifunction.ObjObjLongFunction;

/**
 * Variant of {@link ObjObjLongFunction} capable of throwing a generic
 * {@link Throwable}.
 *
 * @author Marko Zajc
 *
 * @param <T>
 *            the type of the first argument to the function
 * @param <U>
 *            the type of the second argument to the function
 * @param <R>
 *            the type of the result of the function
 * @param <E>
 *            {@link Throwable} type
 */
@FunctionalInterface
public interface EObjObjLongFunction<T, U, R, E extends Throwable> extends ObjObjLongFunction<T, U, R> {

	@Override
	default R apply(T t, U u, long p) {
		try {
			return applyChecked(t, u, p);
		} catch (Throwable e) { // NOSONAR can't catch generic exceptions
			throw asUnchecked(e);
		}
	}

	/**
	 * Same as {@link #apply(Object, Object, long)}, but throws a checked exception.
	 *
	 * @param t
	 *            the first function argument
	 * @param u
	 *            the second function argument
	 * @param p
	 *            the third ({@code long}) function argument
	 *
	 * @return the function result
	 *
	 * @throws E
	 *             the defined exception type
	 */
	R applyChecked(T t, U u, long p) throws E;

}