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

CKTIS / Java

Collection.spliterator — обхождане на елементите на колекция

Collection.spliterator() връща обект за обхождане на елементите на колекция и евентуално разделяне на работата. Научете за реализацията по подразбиране, характеристиките за размер и ограниченията при промени и конкурентен достъп.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

default Spliterator<E> spliterator()

Collection.spliterator() връща Spliterator<E> върху елементите на колекцията. tryAdvance(action) обработва един елемент и връща true, а когато елементите са изчерпани, връща false. forEachRemaining(action) обработва останалите елементи. trySplit() може да отдели част от работата в друг spliterator или да върне null; извикването му не стартира нишки.

Реализацията по подразбиране на Collection използва Iterator, свързва се със източника късно и наследява неговите fail-fast свойства. Тя указва SIZED и SUBSIZED: началният размер е точен при липса на структурни промени, а spliterator-ите, получени чрез разделяне, също имат известен размер. Конкретните колекции могат да предефинират този метод; проверете документацията им.

Късното свързване настъпва при първото обхождане, разделяне или заявка за приблизителния размер. То не означава моментна снимка или безопасност при работа с нишки. Fail-fast откриването е само опит за откриване на грешки, а не механизъм за синхронизация. Освен ако реализацията изрично не гарантира друго, не променяйте източника по време на обхождането.

Методите по подразбиране stream() и parallelStream() използват spliterator-а на колекцията; възможността за разделяне не гарантира ускоряване. Примерът използва подреден List, затова отпечатва елементите в реда на списъка. Самият интерфейс Collection не гарантира този ред.

Примери

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));
    }
}

Резултат

3
10
20
30
false

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

Източници