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

CKTIS / Java

Function.apply — chamar uma função

`apply` recebe um argumento e devolve o resultado. Permite chamar uma única função ou executar uma sequência de funções já composta.

Versão: Java SE 21

Sintaxe

R apply(T t)
R result = function.apply(argument); // function: Function<T, R>

Em Java SE 21, java.util.function.Function<T, R> é uma interface funcional com o método abstrato R apply(T t). Em function.apply(argument), o argumento tem de ser compatível com T e o resultado é do tipo R. Uma expressão lambda ou uma referência a um método pode fornecer a implementação.

O método de instância apply não tem uma sobrecarga sem argumentos. Se function for do tipo Function<T, R>, function.apply() não compila.

f.andThen(g) cria uma função composta que executa primeiro f e depois g. f.compose(g) inverte a ordem: primeiro g e depois f. O resultado da primeira etapa tem de ser compatível com o tipo de entrada da segunda. A composição não executa as etapas: para as executar, chama-se apply com um argumento na função composta. Se uma etapa lançar uma exceção, esta propaga-se a quem fez a chamada.

Exemplos

import java.util.function.Function;

public class Main {
    public static void main(String[] args) {
        Function<String, Integer> length = String::length;
        Function<Integer, String> label = n -> "Length: " + n;
        Function<String, String> pipeline = length.andThen(label);

        System.out.println(length.apply("Java"));
        System.out.println(pipeline.apply("Java"));
    }
}

Resultado

4
Length: 4

`length.apply("Java")` devolve `4`. `pipeline.apply("Java")` passa esse `4` a `label` e devolve o texto `Length: 4`.

Lições relacionadas

  • Java · Lição 62 · Básico · Versão: 2
  • Java · Lição 48 · Intermédio · Versão: 2

Fontes