CKTIS / Java
Spliterator — elementen doorlopen en werk verdelen
java.util.Spliterator maakt het mogelijk elementen te lezen en het resterende bereik op te delen. Eigenschappen van de bron beschrijven onder meer de volgorde en de nauwkeurigheid van de grootte; splitsen alleen start geen parallelle uitvoering.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
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> doorloopt elementen en verdeelt werk. Spliterator.tryAdvance(action) verwerkt één element en retourneert true, of retourneert false als de elementen op zijn. Spliterator.forEachRemaining(action) verwerkt de rest in de huidige thread.
Spliterator.trySplit() splitst een disjunct deel af of retourneert null; het start geen thread. Met Spliterator.ORDERED wordt een voorvoegsel afgesplitst en blijft de encounter-volgorde behouden. Deel één instantie niet tussen threads die gelijktijdig actief zijn.
Spliterator.estimateSize() schat het aantal elementen. De retourwaarde Long.MAX_VALUE kan aangeven dat de grootte onbekend of oneindig is, of te kostbaar om te berekenen, maar kan ook een exact, eindig aantal elementen zijn. Spliterator.SIZED garandeert nauwkeurigheid voordat het doorlopen of splitsen begint, zolang de structuur van de bron niet verandert. In Java 21 meldt LongStream.range(0, Long.MAX_VALUE).spliterator() bijvoorbeeld SIZED en bedraagt het initiële aantal elementen precies Long.MAX_VALUE. Spliterator.SUBSIZED garandeert daarnaast SIZED en SUBSIZED voor alle afstammelingen van de splitsing.
Spliterator.characteristics() retourneert een bitmasker; Spliterator.hasCharacteristics(mask) controleert alle gevraagde bits. Spliterator.NONNULL garandeert dat er geen null-elementen zijn. Spliterator.IMMUTABLE sluit het toevoegen, vervangen en verwijderen van bronelementen uit, maar maakt hun velden niet onveranderlijk.
Het voorbeeld gebruikt Arrays.spliterator, dat ORDERED, SIZED en SUBSIZED meldt. Het verwerkt het afgesplitste voorvoegsel vóór de rest, zodat het resultaat niet afhangt van het splitsingspunt. Wijzig de array niet tijdens het doorlopen.
Voorbeelden
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));
}
}Resultaat
4 true [A, B, C, D] false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.