CKTIS / Java
Function – transformace hodnot a skládání funkcí
Function<T, R> popisuje operaci, která přijímá jeden argument a vrací výsledek. Seznamte se s apply, pořadím provádění andThen a compose a s identickou funkcí.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
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í rozhraní: přijímá argument typu T a vrací výsledek typu R. Lze je implementovat výrazem lambda nebo odkazem na metodu. Function.apply (f.apply(value)) provede operaci.
Function.andThen vytvoří složení: f.andThen(g).apply(x) vypočítá g.apply(f.apply(x)). Function.compose pořadí obrátí: f.compose(g).apply(x) vypočítá f.apply(g.apply(x)). Typy navazujících kroků musí být kompatibilní; samotné složení operace s argumentem neprovádí.
Statická metoda Function.identity() vrátí funkci, která vrací svůj argument beze změny, nikoli jeho kopii.
Předání null jako funkce metodě andThen nebo compose způsobí NullPointerException. Výjimky, ke kterým dojde při provádění kroků, se předávají volajícímu. To neznamená obecný zákaz argumentů null pro apply: jejich zpracování závisí na implementaci.
Pří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ýsledek
4 8 7 3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.