CKTIS / Java
Spliterator — обхождане на елементи и разделяне на работата
java.util.Spliterator позволява четене на елементи и разделяне на оставащия диапазон. Характеристиките на източника описват свойства като реда и точността на размера; самото разделяне не стартира паралелно изпълнение.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
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> обхожда елементи и разделя работата. Spliterator.tryAdvance(action) обработва един елемент и връща true, или връща false, когато елементите се изчерпят. Spliterator.forEachRemaining(action) обработва остатъка в текущата нишка.
Spliterator.trySplit() отделя неприпокриваща се част или връща null; не стартира нишка. При Spliterator.ORDERED отделя начална част, а обхождането запазва реда на срещане. Не споделяйте един и същ екземпляр между нишки, които работят едновременно.
Spliterator.estimateSize() оценява броя на елементите. Върнатата стойност Long.MAX_VALUE може да означава, че размерът е неизвестен, безкраен или твърде скъп за изчисляване, но може да е и точен краен брой елементи. Spliterator.SIZED гарантира точността преди началото на обхождането или разделянето, ако няма структурни промени в източника. Например в Java 21 LongStream.range(0, Long.MAX_VALUE).spliterator() посочва характеристиката SIZED и началният брой елементи е точно Long.MAX_VALUE. Spliterator.SUBSIZED допълнително гарантира SIZED и SUBSIZED за всички наследници на разделянето.
Spliterator.characteristics() връща битова маска; Spliterator.hasCharacteristics(mask) проверява всички зададени битове. Spliterator.NONNULL гарантира, че няма елементи null. Spliterator.IMMUTABLE изключва добавянето, замяната и премахването на елементи от източника, но не прави полетата им неизменяеми.
Примерът използва Arrays.spliterator, който посочва ORDERED, SIZED и SUBSIZED. Обработва отделената начална част преди остатъка, така че резултатът не зависи от мястото на разделяне. Не променяйте масива по време на обхождането.
Примери
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));
}
}Резултат
4 true [A, B, C, D] false
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.