Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

Stream — cevovodi za obdelavo elementov

Stream<T> obdeluje reference na objekte z uporabo lenega cevovoda. Spoznajte ustvarjanje tokov, rezultatske matrike, preslikavo v primitivne tipe in jamstva glede vrstnega reda pojavitve.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

Stream.of(values).mapToInt(mapper)
Stream.of(values).mapToLong(mapper)
Stream.of(values).toArray()
Stream.of(values).toArray(String[]::new)
Stream.of(values).forEachOrdered(action)

java.util.stream.Stream<T> opisuje obdelavo elementov, ne pa zbirke, ki shranjuje podatke. Cevovod sestavljajo vir, vmesne operacije in zaključna operacija. Vmesne operacije so lene: obdelavo sproži zaključna operacija.

Stream.of(T) ustvari tok z enim elementom; Stream.of(T... values) ustvari zaporeden, urejen tok podanih vrednosti. Porabljenega toka ne uporabite znova; za nov izračun ustvarite novega. Funkcije za preslikavo naj ne spreminjajo vira in naj ne bodo odvisne od spremenljivega stanja.

Stream.toArray() zaključi cevovod in vrne Object[]. Preobremenitev Stream.toArray(String[]::new) ustvari String[]; nezdružljiv tip elementa povzroči ArrayStoreException. Stream.mapToInt in Stream.mapToLong sta vmesni operaciji, ki vrneta IntStream oziroma LongStream. Njuni metodi toArray() vrneta int[] oziroma long[], ne pa matrik objektov ovojnic.

Stream.forEachOrdered zaključi cevovod in izvede dejanja v vrstnem redu pojavitve, kadar je ta določen, tudi pri vzporedni obdelavi. Podatkov ne razvršča in ne zagotavlja, da bo dejanja izvajala samo ena nit. Vzporedni forEach pa vrstnega reda ne zagotavlja.

Obseg dokumentacije: Java SE 21; niti izvajalno okolje repozitorija niti produkcijsko izvajalno okolje ni potrjeno.

Primeri

import java.util.Arrays;
import java.util.stream.Stream;

public class Main {
    public static void main(String[] args) {
        String[] words = Stream.of("sun", "moon").toArray(String[]::new);
        int[] lengths = Stream.of(words).mapToInt(String::length).toArray();
        long[] sizes = Stream.of(words).mapToLong(s -> (long) s.length()).toArray();

        System.out.println(Arrays.toString(words));
        System.out.println(Arrays.toString(lengths));
        System.out.println(Arrays.toString(sizes));
        Stream.of(words).parallel().forEachOrdered(System.out::println);
    }
}

Rezultat

[sun, moon]
[3, 4]
[3, 4]
sun
moon

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri