База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници