com.annimon.stream.function

Class Function.Util

java.lang.Object

com.annimon.stream.function.Function.Util

Enclosing interface:

Function<T,R>

public static class Function.Util
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
static <T,R,V> Function<T,V>	andThen(Function<? super T,? extends R> f1, Function<? super R,? extends V> f2) Composes Function calls.
static <V,T,R> Function<V,R>	compose(Function<? super T,? extends R> f1, Function<? super V,? extends T> f2) Composes Function calls.
static <T,R> Function<T,R>	safe(ThrowableFunction<? super T,? extends R,java.lang.Throwable> throwableFunction) Creates a safe Function,
static <T,R> Function<T,R>	safe(ThrowableFunction<? super T,? extends R,java.lang.Throwable> throwableFunction, R resultIfFailed) Creates a safe Function,

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

compose

public static <V,T,R> Function<V,R> compose(Function<? super T,? extends R> f1,
                                            Function<? super V,? extends T> f2)

Composes Function calls.

f1.apply(f2.apply(v))

Type Parameters:

V - the type of the input argument of first function

T - the type of the result of f2 and input argument of f1

R - the type of the result of composed function f1

Parameters:

f1 - the function for transform Function f2 result to the type R

f2 - the Function which is called first

Returns:

the result of composed function

Throws:

java.lang.NullPointerException - if f1 or f2 or result of Function f1 is null

See Also:

andThen(com.annimon.stream.function.Function, com.annimon.stream.function.Function)

andThen

public static <T,R,V> Function<T,V> andThen(Function<? super T,? extends R> f1,
                                            Function<? super R,? extends V> f2)

Composes Function calls.

f2.apply(f1.apply(t))

Type Parameters:

T - the type of the input argument of first function

R - the type of the result of f1 and input argument of f2

V - the type of the result of composed function f2

Parameters:

f1 - the Function which is called first

f2 - the function for transform Function f1 result to the type V

Returns:

the result of composed function

Throws:

java.lang.NullPointerException - if f1 or f2 or result of Function f1 is null

See Also:

compose(com.annimon.stream.function.Function, com.annimon.stream.function.Function)

safe

public static <T,R> Function<T,R> safe(ThrowableFunction<? super T,? extends R,java.lang.Throwable> throwableFunction)

Creates a safe Function,

Type Parameters:

T - the type of the input of the function

R - the type of the result of the function

Parameters:

throwableFunction - the function that may throw an exception

Returns:

the function result or null if exception was thrown

Throws:

java.lang.NullPointerException - if throwableFunction is null

See Also:

safe(com.annimon.stream.function.ThrowableFunction, java.lang.Object)

safe

public static <T,R> Function<T,R> safe(ThrowableFunction<? super T,? extends R,java.lang.Throwable> throwableFunction,
                                       R resultIfFailed)

Creates a safe Function,

Type Parameters:

T - the type of the input of the function

R - the type of the result of the function

Parameters:

throwableFunction - the function that may throw an exception

resultIfFailed - the result which returned if exception was thrown

Returns:

the function result or resultIfFailed

Throws:

java.lang.NullPointerException - if throwableFunction is null

See Also:

safe(com.annimon.stream.function.ThrowableFunction)