Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

Collection.spliterator — prolazak kroz elemente kolekcije

Collection.spliterator() vraća objekt za prolazak kroz elemente kolekcije i moguće dijeljenje posla. Saznajte više o zadanoj implementaciji, značajkama veličine i ograničenjima povezanima s izmjenama i istodobnošću.

Verzija: Java SE 21; repository runtime, production runtime not attested

Sintaksa

default Spliterator<E> spliterator()

Collection.spliterator() vraća Spliterator<E> nad elementima kolekcije. tryAdvance(action) obrađuje jedan element i vraća true, a kada više nema elemenata, vraća false. forEachRemaining(action) obrađuje preostale elemente. trySplit() može izdvojiti dio posla u drugi spliterator ili vratiti null; njegov poziv ne pokreće dretve.

Zadana implementacija Collection upotrebljava Iterator, kasno se povezuje s izvorom i nasljeđuje njegova fail-fast svojstva. Navodi SIZED i SUBSIZED: početna je veličina točna ako nema strukturnih izmjena, a poznatu veličinu imaju i spliteratori dobiveni dijeljenjem. Konkretne kolekcije mogu nadjačati ovu metodu; provjerite njihovu dokumentaciju.

Kasno povezivanje događa se pri prvom prolasku, dijeljenju ili upitu o procijenjenoj veličini. Ono ne podrazumijeva snimku ni sigurnost pri radu s više dretvi. Fail-fast otkrivanje samo je najbolji pokušaj otkrivanja pogreške, a ne mehanizam sinkronizacije. Ako implementacija izričito ne jamči drukčije, nemojte mijenjati izvor tijekom prolaska.

Zadane metode stream() i parallelStream() upotrebljavaju spliterator kolekcije; mogućnost dijeljenja ne jamči ubrzanje. Primjer upotrebljava uređeni List, pa ispisuje elemente redoslijedom popisa. Samo sučelje Collection ne jamči taj redoslijed.

Primjeri

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

Rezultat

3
10
20
30
false

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori