CKTIS / Java
Collection.spliterator — parcourir les éléments d’une collection
Collection.spliterator() renvoie un objet permettant de parcourir les éléments d’une collection et, éventuellement, de répartir le travail. Découvrez l’implémentation par défaut, les caractéristiques de taille et les limites liées aux modifications et à la concurrence.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
default Spliterator<E> spliterator()Collection.spliterator() renvoie un Spliterator<E> parcourant les éléments de la collection. tryAdvance(action) traite un élément et renvoie true, ou renvoie false lorsqu’il n’y a plus d’éléments. forEachRemaining(action) traite les éléments restants. trySplit() peut séparer une partie du travail dans un autre spliterator ou renvoyer null ; son appel ne démarre pas de threads.
L’implémentation par défaut de Collection utilise un Iterator, se lie tardivement à la source et hérite de ses propriétés fail-fast. Elle signale SIZED et SUBSIZED : la taille initiale est exacte en l’absence de modification structurelle, et les spliterators obtenus par division ont également une taille connue. Les collections concrètes peuvent redéfinir cette méthode ; consultez leur documentation.
La liaison tardive a lieu lors du premier parcours, de la première division ou de la première demande de taille estimée. Elle n’implique ni instantané ni sécurité vis-à-vis des threads. La détection fail-fast est une tentative de détection d’erreurs au mieux, et non un mécanisme de synchronisation. Sauf garantie explicite de l’implémentation, ne modifiez pas la source pendant le parcours.
Les méthodes par défaut stream() et parallelStream() utilisent le spliterator de la collection ; la possibilité de division ne garantit pas une accélération. L’exemple utilise une List ordonnée et affiche donc les éléments dans l’ordre de la liste. L’interface Collection seule ne garantit pas cet ordre.
Exemples
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));
}
}Résultat
3 10 20 30 false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.