com.linkedin.dagli.util.function.Function4 Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of util-function Show documentation
Show all versions of util-function Show documentation
DAG-oriented machine learning framework for bug-resistant, readable, efficient, maintainable and trivially deployable models in Java and other JVM languages
// AUTOGENERATED CODE. DO NOT MODIFY DIRECTLY! Instead, please modify the util/function/Function.ftl file.
// See the README in the module's src/template directory for details.
package com.linkedin.dagli.util.function;
import com.linkedin.dagli.util.exception.Exceptions;
@FunctionalInterface
public interface Function4 extends FunctionBase {
R apply(A value1, B value2, C value3, D value4);
/**
* Returns a new function that wraps this "original" function. The wrapping function will return null
* without calling the original function if any argument is null. If no argument is null, the original function will
* be called as normal and its return value will be returned by the wrapping function.
*
* This is useful when you have a function that cannot accept a null as an argument but are satisfied to just return
* a default value in such instances.
*
* @return a new function that calls this one if all arguments or non-null, or returns a default value otherwise.
*/
default Function4 returnNullOnNullArgument() {
return new DefaultOnNullArgument4<>(this);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @param the type of the result of the composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default Function4 andThen(Function1 mapper) {
return new ComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default VoidFunction4 andThenToVoid(VoidFunction1 mapper) {
return new VoidComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default BooleanFunction4 andThenToBoolean(BooleanFunction1 mapper) {
return new BooleanComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default ByteFunction4 andThenToByte(ByteFunction1 mapper) {
return new ByteComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default CharacterFunction4 andThenToCharacter(CharacterFunction1 mapper) {
return new CharacterComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default ShortFunction4 andThenToShort(ShortFunction1 mapper) {
return new ShortComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default IntFunction4 andThenToInt(IntFunction1 mapper) {
return new IntComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default LongFunction4 andThenToLong(LongFunction1 mapper) {
return new LongComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default FloatFunction4 andThenToFloat(FloatFunction1 mapper) {
return new FloatComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default DoubleFunction4 andThenToDouble(DoubleFunction1 mapper) {
return new DoubleComposedFunction4<>(this, mapper);
}
static Function4 unchecked(Checked checkedFunction) {
return (A value1, B value2, C value3, D value4) -> {
try {
return checkedFunction.apply(value1, value2, value3, value4);
} catch (Throwable e) {
throw Exceptions.asRuntimeException(e);
}
};
}
@FunctionalInterface
interface Checked extends FunctionBase {
R apply(A value1, B value2, C value3, D value4) throws X;
}
interface Serializable extends Function4, java.io.Serializable {
/**
* Creates a new, safely-serializable function from this one if this is a method reference (e.g. Object::toString),
* or simply returns this if this is a function object. If this is something not safely serializable (e.g. a
* lambda), an exception will be thrown.
*
* "Safely-serializable" means that a function can be deserialized in a way that is not inherently brittle.
* We recommend only serializing functions when they are safely-serializable, but note that this is not a guarantee;
* as with Serializable objects in general it's always possible to create something (safely-)serializable that will
* not serialize, e.g. an instance method with a captured instance (e.g. new Object()::toString) where the captured
* instance is not itself serializable.
*
* Function objects that wrap functions and implement Function4.Serializable should override this method
* when appropriate. Generally such an implementation will simply create a new instance wrapping
* wrappedFunction.safelySerializable() instead of wrappedFunction.
*
* Anonymous lambdas, such as "{@code a -> a + 5}", are *not* safely-serializable, even if they are technically
* serializable, as they are extraordinarily fragile and will only deserialize correctly under these conditions:
* (1) the class in which they were created must exist in both serializing and deserializing programs.
* (2) the ORDER in which the lambdas are defined must not change. The names of the generated anonymous classes are
* dependent upon the position in which the lambda appears in the file!
* (3) the JVM should be consistent, as different JVMs are in principle free to generate different class names.
*/
default Serializable safelySerializable() {
try {
return new MethodReference4(this);
} catch (java.lang.RuntimeException e) {
if (e.getCause() instanceof java.lang.NoSuchMethodException) {
// must be a function object
return this;
} else {
// anonymous lambda or something went wrong
throw e;
}
}
}
@Override
default Serializable returnNullOnNullArgument() {
return new DefaultOnNullArgument4(this);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @param the type of the result of the composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default Function4.Serializable andThen(Function1.Serializable mapper) {
return new ComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default VoidFunction4.Serializable andThenToVoid(VoidFunction1.Serializable mapper) {
return new VoidComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default BooleanFunction4.Serializable andThenToBoolean(BooleanFunction1.Serializable mapper) {
return new BooleanComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default ByteFunction4.Serializable andThenToByte(ByteFunction1.Serializable mapper) {
return new ByteComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default CharacterFunction4.Serializable andThenToCharacter(
CharacterFunction1.Serializable mapper) {
return new CharacterComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default ShortFunction4.Serializable andThenToShort(ShortFunction1.Serializable mapper) {
return new ShortComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default IntFunction4.Serializable andThenToInt(IntFunction1.Serializable mapper) {
return new IntComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default LongFunction4.Serializable andThenToLong(LongFunction1.Serializable mapper) {
return new LongComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default FloatFunction4.Serializable andThenToFloat(FloatFunction1.Serializable mapper) {
return new FloatComposedFunction4<>(this, mapper);
}
/**
* Composes this function with another by mapping the result of this function. The returned function is equivalent
* to {@code mapper.apply(this.apply(...))}.
*
* This method is analogous to {@link java.util.function.Function#andThen(Function)}.
*
* @param mapper the function that will map the result of this one in the returned composed function
* @return a composed function equivalent to {@code mapper.apply(this.apply(...))}
*/
default DoubleFunction4.Serializable andThenToDouble(DoubleFunction1.Serializable mapper) {
return new DoubleComposedFunction4<>(this, mapper);
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy