CKTIS / Java
Arrays.stream(T[]): ustvarjanje toka iz polja
Uporabi polje elementov referenčnega tipa kot vir zaporednega toka, filtriraj elemente in shrani rezultat v polje ustreznega tipa.
Različica: Java SE 21
Sintaksa
public static <T> Stream<T> stream(T[] array)Arrays.stream(T[]) je statična metoda razreda java.util.Arrays, na voljo od Jave 8. Polje elementov referenčnega tipa uporabi kot vir zaporednega toka java.util.stream.Stream<T>, katerega elementi si sledijo po indeksih. Iz String[] na primer nastane Stream<String>. Metoda izvornega polja ne kopira. Če namesto reference na polje podaš null, se sproži NullPointerException.
Vmesne operacije, kot je filter, se izvajajo leno: obdelava se začne šele ob klicu končne operacije, kot je toArray(). Med obdelavo ne spreminjaj izvornega polja. Po končni operaciji istega toka ne uporabi znova. Za ponovno obdelavo polja ustvari nov tok.
Preobremenjena različica z obsegom, Arrays.stream(array, startInclusive, endExclusive), vključuje začetni indeks, končnega pa ne. Veljati mora 0 <= startInclusive <= endExclusive <= array.length; pri neveljavnih mejah se sproži ArrayIndexOutOfBoundsException. Različice za int[], long[] in double[] vrnejo IntStream, LongStream oziroma DoubleStream. Za druga enodimenzionalna polja primitivnih tipov, na primer boolean[], neposredne različice ni.
Pri Stream<T> je deklarirani povratni tip metode toArray() brez argumentov Object[], vendar Java SE 21 ne določa natančnega razreda vrnjenega polja med izvajanjem. Rezultata ne pretvarjaj v String[] z vsiljeno pretvorbo tipa. Če potrebuješ String[], na toku nizov uporabi toArray(String[]::new).
Pri uporabi refleksije lahko dobljeni Object[] podaš metodi Constructor.newInstance(Object...). Njegovi elementi po vrsti postanejo argumenti izbranega konstruktorja. Njihovo število, vrstni red in tipi se morajo ujemati s parametri konstruktorja ob upoštevanju dovoljenih pretvorb. Napačno število argumentov ali nezdružljiv tip sproži IllegalArgumentException.
Primeri
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` izloči niz, ki vsebuje le en presledek. `toArray()` shrani `Ada` in `Lin` v `Object[]` v tem vrstnem redu, `newInstance` pa ju poda kot dva argumenta konstruktorju `Pair`.
Povezane lekcije
- Java · Lekcija 59 · Napredna · Različica: 2
- Java · Lekcija 63 · Osnovna · Različica: 2