Stay organized with collections Save and categorize content based on your preferences.

public interface Function

java.util.function.Function<T, R>

Known indirect subclasses

UnaryOperator<T> Represents an operation on a single operand that produces a result of the same type as its operand. 


Represents a function that accepts one argument and produces a result.

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

Summary

Public methods

default <V> Function<T, V> andThen(Function<? super R, ? extends V> after)

Returns a composed function that first applies this function to its input, and then applies the after function to the result.

abstract R apply(T t)

Applies this function to the given argument.

default <V> Function<V, R> compose(Function<? super V, ? extends T> before)

Returns a composed function that first applies the before function to its input, and then applies this function to the result.

static <T> Function<T, T> identity()

Returns a function that always returns its input argument.

Public methods

andThen

public Function<T, V> andThen (Function<? super R, ? extends V> after)

Returns a composed function that first applies this function to its input, and then applies the after function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.

Parameters
after Function: the function to apply after this function is applied
Returns
Function<T, V> a composed function that first applies this function and then applies the after function
Throws
NullPointerException if after is null

apply

public abstract R apply (T t)

Applies this function to the given argument.

Parameters
t T: the function argument
Returns
R the function result

compose

public Function<V, R> compose (Function<? super V, ? extends T> before)

Returns a composed function that first applies the before function to its input, and then applies this function to the result. If evaluation of either function throws an exception, it is relayed to the caller of the composed function.

Parameters
before Function: the function to apply before this function is applied
Returns
Function<V, R> a composed function that first applies the before function and then applies this function
Throws
NullPointerException if before is null

identity

public static Function<T, T> identity ()

Returns a function that always returns its input argument.

Returns
Function<T, T> a function that always returns its input argument

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2019-12-27 UTC.