Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Spliterator — prolazak kroz elemente i podjela posla

java.util.Spliterator omogućuje čitanje elemenata i podjelu preostalog raspona. Svojstva izvora opisuju, među ostalim, redoslijed i točnost veličine; sama podjela ne pokreće paralelno izvođenje.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

Spliterator<T> s = Arrays.spliterator(array);
boolean advanced = s.tryAdvance(action);
Spliterator<T> prefix = s.trySplit();
long estimate = s.estimateSize();
int flags = s.characteristics();
boolean sized = s.hasCharacteristics(Spliterator.SIZED);
s.forEachRemaining(action);

java.util.Spliterator<T> prolazi kroz elemente i dijeli posao. Spliterator.tryAdvance(action) obrađuje jedan element i vraća true ili vraća false kada ponestane elemenata. Spliterator.forEachRemaining(action) obrađuje ostatak u trenutačnoj dretvi.

Spliterator.trySplit() izdvaja disjunktni dio ili vraća null; ne pokreće nijednu dretvu. Uz Spliterator.ORDERED izdvaja početni dio, a prolazak čuva redoslijed elemenata. Nemoj dijeliti istu instancu između dretvi koje rade istodobno.

Spliterator.estimateSize() procjenjuje broj elemenata. Povratna vrijednost Long.MAX_VALUE može značiti da je veličina nepoznata, beskonačna ili preskupa za izračun, ali može biti i točan konačan broj elemenata. Spliterator.SIZED jamči točnost prije početka prolaska ili podjele, pod uvjetom da nema strukturnih promjena izvora. Na primjer, u Javi 21 LongStream.range(0, Long.MAX_VALUE).spliterator() navodi svojstvo SIZED i početni broj elemenata iznosi točno Long.MAX_VALUE. Spliterator.SUBSIZED dodatno jamči SIZED i SUBSIZED za sve potomke podjele.

Spliterator.characteristics() vraća bitnu masku; Spliterator.hasCharacteristics(mask) provjerava sve tražene bitove. Spliterator.NONNULL jamči da nema elemenata null. Spliterator.IMMUTABLE isključuje dodavanje, zamjenu i uklanjanje elemenata izvora, ali ne čini njihova polja nepromjenjivima.

Primjer upotrebljava Arrays.spliterator, koji navodi ORDERED, SIZED i SUBSIZED. Obrađuje izdvojeni početni dio prije ostatka, pa rezultat ne ovisi o mjestu podjele. Ne mijenjaj polje tijekom prolaska.

Primjeri

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Spliterator;

public class Main {
    public static void main(String[] args) {
        Spliterator<String> rest = Arrays.spliterator(
                new String[]{"A", "B", "C", "D"});
        System.out.println(rest.estimateSize());
        System.out.println(rest.hasCharacteristics(
                Spliterator.ORDERED | Spliterator.SIZED | Spliterator.SUBSIZED));

        Spliterator<String> prefix = rest.trySplit();
        List<String> visited = new ArrayList<>();
        if (prefix != null) {
            prefix.tryAdvance(visited::add);
            prefix.forEachRemaining(visited::add);
        }
        rest.forEachRemaining(visited::add);
        System.out.println(visited);
        System.out.println(rest.tryAdvance(visited::add));
    }
}

Rezultat

4
true
[A, B, C, D]
false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori