CKTIS / Java
Collection.spliterator — elementen van een collectie doorlopen
Collection.spliterator() geeft een object terug waarmee je de elementen van een collectie kunt doorlopen en het werk eventueel kunt verdelen. Lees over de standaardimplementatie, groottekenmerken en beperkingen rond wijzigingen en gelijktijdigheid.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
default Spliterator<E> spliterator()Collection.spliterator() geeft een Spliterator<E> over de elementen van de collectie terug. tryAdvance(action) verwerkt één element en geeft true terug, of geeft false terug als er geen elementen meer zijn. forEachRemaining(action) verwerkt de resterende elementen. trySplit() kan een deel van het werk afsplitsen naar een andere spliterator of null teruggeven; de aanroep start geen threads.
De standaardimplementatie van Collection gebruikt een Iterator, bindt laat aan de bron en erft diens fail-fast-eigenschappen. De implementatie meldt SIZED en SUBSIZED: zonder structurele wijzigingen is de beginomvang exact, en spliterators die door splitsing ontstaan hebben ook een bekende omvang. Concrete collecties kunnen deze methode overschrijven; raadpleeg hun documentatie.
Late binding vindt plaats bij de eerste doorgang, splitsing of aanvraag van de geschatte omvang. Dit betekent niet dat er een snapshot wordt gemaakt of dat de bewerking thread-safe is. Fail-fast-detectie is slechts een poging om fouten te signaleren, geen synchronisatiemechanisme. Wijzig de bron tijdens het doorlopen niet, tenzij de implementatie dit uitdrukkelijk garandeert.
De standaardmethoden stream() en parallelStream() gebruiken de spliterator van de collectie; de mogelijkheid om te splitsen garandeert geen snelheidswinst. Het voorbeeld gebruikt een geordende List en drukt de elementen daarom af in de volgorde van de lijst. De interface Collection garandeert die volgorde op zichzelf niet.
Voorbeelden
import java.util.Collection;
import java.util.List;
import java.util.Spliterator;
public class Main {
public static void main(String[] args) {
Collection<Integer> values = List.of(10, 20, 30);
Spliterator<Integer> cursor = values.spliterator();
System.out.println(cursor.getExactSizeIfKnown());
cursor.tryAdvance(System.out::println);
cursor.forEachRemaining(System.out::println);
System.out.println(cursor.tryAdvance(System.out::println));
}
}Resultaat
3 10 20 30 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.