Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes