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.