CKTIS / Java
Collection.spliterator — attraversare gli elementi di una collection
Collection.spliterator() restituisce un oggetto per attraversare gli elementi di una collection e, se possibile, suddividere il lavoro. Scopri l’implementazione predefinita, le caratteristiche relative alle dimensioni e i limiti riguardanti modifiche e concorrenza.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
default Spliterator<E> spliterator()Collection.spliterator() restituisce un Spliterator<E> sugli elementi della collection. tryAdvance(action) elabora un elemento e restituisce true, oppure restituisce false quando gli elementi sono esauriti. forEachRemaining(action) elabora gli elementi rimanenti. trySplit() può separare una parte del lavoro in un altro spliterator oppure restituire null; chiamarlo non avvia thread.
L’implementazione predefinita di Collection usa un Iterator, si collega in modo differito alla sorgente ed eredita le sue proprietà fail-fast. Dichiara SIZED e SUBSIZED: la dimensione iniziale è esatta in assenza di modifiche strutturali e anche gli spliterator ottenuti tramite suddivisione hanno dimensioni note. Le collection concrete possono sovrascrivere questo metodo; consulta la loro documentazione.
Il collegamento differito avviene al primo attraversamento, alla prima suddivisione o alla prima richiesta della dimensione stimata. Non implica uno snapshot né la sicurezza per l’uso concorrente. Il rilevamento fail-fast è solo un tentativo di individuare errori, non un meccanismo di sincronizzazione. A meno che l’implementazione non lo garantisca esplicitamente, non modificare la sorgente durante l’attraversamento.
I metodi predefiniti stream() e parallelStream() usano lo spliterator della collection; la possibilità di suddividere il lavoro non garantisce un aumento delle prestazioni. L’esempio usa una List ordinata, quindi stampa gli elementi nell’ordine della lista. La sola interfaccia Collection non garantisce tale ordine.
Esempi
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));
}
}Risultato
3 10 20 30 false
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.