CKTIS / Java
Arrays.stream(T[]): vytvoření proudu z pole
Použij pole prvků referenčního typu jako zdroj sekvenčního proudu, vyfiltruj jeho prvky a ulož výsledek do pole vhodného typu.
Verze: Java SE 21
Syntaxe
public static <T> Stream<T> stream(T[] array)Arrays.stream(T[]) je statická metoda třídy java.util.Arrays, dostupná od Javy 8. Používá pole prvků referenčního typu jako zdroj sekvenčního proudu java.util.stream.Stream<T> v pořadí indexů. Například z String[] vznikne Stream<String>. Metoda zdrojové pole nekopíruje. Předání null místo reference na pole vyvolá NullPointerException.
Mezilehlé operace jako filter se vyhodnocují líně: zpracování začne až zavoláním koncové operace, jako je toArray(). Během zpracování neměň zdrojové pole. Po koncové operaci stejný proud znovu nepoužívej. Chceš-li pole zpracovat znovu, vytvoř nový proud.
Přetížená varianta s rozsahem, Arrays.stream(array, startInclusive, endExclusive), zahrnuje počáteční index, ale nezahrnuje koncový. Vyžaduje 0 <= startInclusive <= endExclusive <= array.length; neplatné meze vyvolají ArrayIndexOutOfBoundsException. Varianty pro int[], long[] a double[] vracejí postupně IntStream, LongStream a DoubleStream. Pro jiná jednorozměrná pole primitivních typů, například boolean[], přímá varianta neexistuje.
U Stream<T> je deklarovaným návratovým typem bezparametrové metody toArray() typ Object[], ale Java SE 21 neurčuje přesnou běhovou třídu vráceného pole. Nepřetypovávej výsledek na String[]. Pokud potřebuješ String[], použij toArray(String[]::new) na proudu řetězců.
Při použití reflexe můžeš výsledné Object[] předat do Constructor.newInstance(Object...). Jeho prvky se postupně použijí jako argumenty vybraného konstruktoru. Jejich počet, pořadí a typy musí odpovídat parametrům konstruktoru s ohledem na povolené konverze. Nesprávný počet argumentů nebo nekompatibilní typ vyvolá IllegalArgumentException.
Příklady
import java.util.Arrays;
public class Main {
public record Pair(String first, String second) {}
public static void main(String[] args) throws ReflectiveOperationException {
String[] input = {"Ada", " ", "Lin"};
Object[] arguments = Arrays.stream(input)
.filter(name -> !name.isBlank())
.toArray();
Pair pair = Pair.class.getConstructor(String.class, String.class)
.newInstance(arguments);
System.out.println(Arrays.toString(arguments));
System.out.println(pair.first() + " / " + pair.second());
}
}Výsledek
[Ada, Lin] Ada / Lin
`filter` vyřadí řetězec obsahující jen jednu mezeru. `toArray()` vloží `Ada` a `Lin` v tomto pořadí do `Object[]` a `newInstance` je předá jako dva argumenty konstruktoru `Pair`.
Související lekce
- Java · Lekce 59 · Pokročilá · Verze: 2
- Java · Lekce 63 · Základní · Verze: 2