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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.