CKTIS / Java
Spliterator — parcourir les éléments et répartir le travail
java.util.Spliterator permet de lire des éléments et de diviser la plage restante. Les caractéristiques de la source décrivent notamment l’ordre et la précision de la taille ; le découpage seul ne lance pas d’exécution parallèle.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
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> parcourt les éléments et répartit le travail. Spliterator.tryAdvance(action) traite un élément et renvoie true, ou renvoie false lorsque la source est épuisée. Spliterator.forEachRemaining(action) traite le reste dans le thread courant.
Spliterator.trySplit() détache une partie disjointe ou renvoie null ; il ne lance aucun thread. Avec Spliterator.ORDERED, il détache un préfixe et le parcours préserve l’ordre de rencontre. Ne partagez pas une même instance entre des threads qui travaillent simultanément.
Spliterator.estimateSize() estime le nombre d’éléments. La valeur renvoyée Long.MAX_VALUE peut indiquer que la taille est inconnue, infinie ou trop coûteuse à calculer, mais elle peut aussi correspondre à un nombre exact et fini d’éléments. Spliterator.SIZED garantit l’exactitude avant le début du parcours ou du découpage, en l’absence de modification structurelle de la source. Par exemple, dans Java 21, LongStream.range(0, Long.MAX_VALUE).spliterator() signale SIZED et sa taille initiale est exactement de Long.MAX_VALUE éléments. Spliterator.SUBSIZED garantit en plus SIZED et SUBSIZED pour tous les descendants issus du découpage.
Spliterator.characteristics() renvoie un masque de bits ; Spliterator.hasCharacteristics(mask) vérifie tous les bits demandés. Spliterator.NONNULL garantit l’absence d’éléments null. Spliterator.IMMUTABLE exclut l’ajout, le remplacement et la suppression d’éléments de la source, mais ne rend pas leurs champs immuables.
L’exemple utilise Arrays.spliterator, qui indique ORDERED, SIZED et SUBSIZED. Il traite le préfixe détaché avant le reste ; le résultat ne dépend donc pas du point de découpage. Ne modifiez pas le tableau pendant le parcours.
Exemples
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));
}
}Résultat
4 true [A, B, C, D] 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.