WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Function – Werte transformieren und Funktionen verknüpfen

Function<T, R> beschreibt eine Operation, die ein Argument entgegennimmt und ein Ergebnis zurückgibt. Lerne apply, die Ausführungsreihenfolge von andThen und compose sowie die Identitätsfunktion kennen.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

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> ist ein funktionales Interface: Es nimmt ein Argument vom Typ T entgegen und gibt ein Ergebnis vom Typ R zurück. Es lässt sich mit einem Lambda-Ausdruck oder einem Methodenverweis implementieren. Function.apply (f.apply(value)) führt die Operation aus.

Function.andThen erstellt eine Verkettung: f.andThen(g).apply(x) berechnet g.apply(f.apply(x)). Function.compose kehrt die Reihenfolge um: f.compose(g).apply(x) berechnet f.apply(g.apply(x)). Die Typen aufeinanderfolgender Schritte müssen kompatibel sein; die Verknüpfung selbst führt die Operationen nicht für ein Argument aus.

Die statische Methode Function.identity() gibt eine Funktion zurück, die ihr Argument unverändert zurückgibt, nicht eine Kopie davon.

Wird null als Funktion an andThen oder compose übergeben, tritt eine NullPointerException auf. Ausnahmen während der Ausführung der Schritte werden an den Aufrufer weitergegeben. Das bedeutet nicht, dass null-Argumente für apply generell unzulässig sind: Ihre Behandlung hängt von der Implementierung ab.

Beispiele

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));
    }
}

Ergebnis

4
8
7
3

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen