Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Function — przekształcanie wartości i składanie funkcji

Function<T, R> opisuje operację przyjmującą jeden argument i zwracającą wynik. Poznaj apply, kolejność działania andThen i compose oraz funkcję tożsamościową identity.

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

Składnia

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> jest interfejsem funkcyjnym: przyjmuje argument typu T i zwraca wynik typu R. Można go implementować lambdą lub referencją do metody. Function.apply (f.apply(value)) wykonuje operację.

Function.andThen tworzy złożenie: f.andThen(g).apply(x) oblicza g.apply(f.apply(x)). Function.compose odwraca kolejność: f.compose(g).apply(x) oblicza f.apply(g.apply(x)). Typy łączonych etapów muszą być zgodne; samo złożenie nie wykonuje operacji na argumencie.

Statyczna metoda Function.identity() zwraca funkcję oddającą otrzymany argument bez zmian, a nie jego kopię.

Przekazanie null jako funkcji do andThen lub compose powoduje NullPointerException. Wyjątki podczas wykonywania etapów są przekazywane wywołującemu. To nie oznacza ogólnego zakazu argumentów null dla apply: ich obsługa zależy od implementacji.

Przykłady

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

Wynik

4
8
7
3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła