CKTIS / Java
Function – transformácia hodnôt a skladanie funkcií
Function<T, R> opisuje operáciu, ktorá prijme jeden argument a vráti výsledok. Spoznajte apply, poradie vykonávania andThen a compose a identickú funkciu.
Verzia: 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> je funkčné rozhranie: prijíma argument typu T a vracia výsledok typu R. Možno ho implementovať výrazom lambda alebo odkazom na metódu. Function.apply (f.apply(value)) vykoná operáciu.
Function.andThen vytvorí skladanie: f.andThen(g).apply(x) vypočíta g.apply(f.apply(x)). Function.compose poradie obráti: f.compose(g).apply(x) vypočíta f.apply(g.apply(x)). Typy nadväzujúcich krokov musia byť kompatibilné; samotné skladanie operácie s argumentom nevykoná.
Statická metóda Function.identity() vráti funkciu, ktorá vráti svoj argument bez zmeny, nie jeho kópiu.
Odovzdanie null ako funkcie metóde andThen alebo compose spôsobí NullPointerException. Výnimky, ktoré vzniknú počas vykonávania krokov, sa propagujú volajúcemu. To neznamená všeobecný zákaz argumentov null pre apply: ich spracovanie závisí od implementácie.
Príklady
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));
}
}Výsledok
4 8 7 3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.