Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje