CKTIS / Java
Function — transformar valores e compor funções
Function<T, R> descreve uma operação que aceita um argumento e devolve um resultado. Aprende a usar apply, a ordem de execução de andThen e compose e a função identidade.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Function<T, R> f = value -> expression;
R apply(T t)
default <V> Function<T, V> andThen(Function<? super R, ? extends V> after)
default <V> Function<V, R> compose(Function<? super V, ? extends T> before)
static <T> Function<T, T> identity()java.util.function.Function<T, R> é uma interface funcional: aceita um argumento do tipo T e devolve um resultado do tipo R. Pode ser implementada com uma expressão lambda ou uma referência a método. Function.apply (f.apply(value)) executa a operação.
Function.andThen cria uma composição: f.andThen(g).apply(x) calcula g.apply(f.apply(x)). Function.compose inverte a ordem: f.compose(g).apply(x) calcula f.apply(g.apply(x)). Os tipos das etapas ligadas têm de ser compatíveis; a composição, por si só, não executa as operações sobre um argumento.
O método estático Function.identity() devolve uma função que devolve o seu argumento sem o alterar, e não uma cópia.
Passar null como função a andThen ou compose causa uma NullPointerException. As exceções durante a execução das etapas são propagadas para o chamador. Isto não implica uma proibição geral de argumentos null para apply: o seu tratamento depende da implementação.
Exemplos
import java.util.function.Function;
public class Main {
public static void main(String[] args) {
Function<Integer, Integer> increment = x -> x + 1;
Function<Integer, Integer> doubleValue = x -> x * 2;
Function<Integer, Integer> unchanged = Function.identity();
System.out.println(increment.apply(3));
System.out.println(increment.andThen(doubleValue).apply(3));
System.out.println(increment.compose(doubleValue).apply(3));
System.out.println(unchanged.apply(3));
}
}Resultado
4 8 7 3
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.