Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Arrays.stream(T[]): stvaranje toka iz polja

Upotrijebi polje elemenata referentnog tipa kao izvor slijednog toka, filtriraj elemente i spremi rezultat u polje odgovarajućeg tipa.

Verzija: Java SE 21

Sintaksa

public static <T> Stream<T> stream(T[] array)

Arrays.stream(T[]) statička je metoda klase java.util.Arrays, dostupna od Jave 8. Polje elemenata referentnog tipa koristi kao izvor slijednog toka java.util.stream.Stream<T> prema redoslijedu indeksa. Primjerice, iz String[] nastaje Stream<String>. Metoda ne kopira izvorno polje. Prosljeđivanje vrijednosti null umjesto reference na polje uzrokuje NullPointerException.

Međuoperacije poput filter izvršavaju se odgođeno: obrada počinje tek pozivom završne operacije kao što je toArray(). Ne mijenjaj izvorno polje tijekom obrade. Nemoj ponovno upotrijebiti isti tok nakon završne operacije. Za ponovnu obradu polja stvori novi tok.

Preopterećena inačica s rasponom, Arrays.stream(array, startInclusive, endExclusive), uključuje početni indeks, ali isključuje završni. Mora vrijediti 0 <= startInclusive <= endExclusive <= array.length; nevaljane granice uzrokuju ArrayIndexOutOfBoundsException. Inačice za int[], long[] i double[] vraćaju redom IntStream, LongStream i DoubleStream. Za druga jednodimenzionalna polja primitivnih tipova, poput boolean[], ne postoji izravna inačica.

Za Stream<T> deklarirani povratni tip metode toArray() bez argumenata jest Object[], ali Java SE 21 ne određuje točnu klasu vraćenog polja tijekom izvođenja. Nemoj rezultat pretvarati u String[] eksplicitnom pretvorbom tipa. Ako trebaš String[], na toku znakovnih nizova upotrijebi toArray(String[]::new).

Pri korištenju refleksije dobiveni Object[] možeš proslijediti metodi Constructor.newInstance(Object...). Njegovi elementi redom postaju argumenti odabranog konstruktora. Njihov broj, redoslijed i tipovi moraju odgovarati parametrima konstruktora uz dopuštene pretvorbe. Pogrešan broj argumenata ili nekompatibilan tip uzrokuje IllegalArgumentException.

Primjeri

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());
    }
}

Rezultat

[Ada, Lin]
Ada / Lin

`filter` odbacuje znakovni niz koji sadrži samo jedan razmak. `toArray()` stavlja `Ada` i `Lin` u `Object[]` tim redom, a `newInstance` ih prosljeđuje kao dva argumenta konstruktoru `Pair`.

Povezane lekcije

  • Java · Lekcija 59 · Napredno · Verzija: 2
  • Java · Lekcija 63 · Osnovno · Verzija: 2

Izvori