KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

List.subList — een gekoppelde weergave van een lijstbereik

`List.subList` geeft een aan de oorspronkelijke lijst gekoppelde weergave terug, geen kopie. De beginindex telt mee, de eindindex niet.

Versie: Java SE 21

Syntax

List<E> subList(int fromIndex, int toIndex)
list.subList(fromIndex, toIndex)
Valid bounds: 0 <= fromIndex <= toIndex <= list.size()

List.subList(fromIndex, toIndex) is een instantiemethode van java.util.List<E>. De methode neemt twee int-indices die bij nul beginnen en geeft een List<E> terug voor het halfopen bereik [fromIndex, toIndex). list.subList(2, 5) omvat de indices 2, 3 en 4. list.subList(0, 4) geeft een weergave van de eerste vier elementen van de oorspronkelijke lijst list terug, mits die lijst minstens vier elementen bevat. Ook in de weergave beginnen de indices bij nul.

Voor geldige grenzen geldt 0 <= fromIndex <= toIndex <= list.size(). Twee gelijke, geldige grenzen geven een lege weergave, ook aan het einde van de lijst. Het contract van List vermeldt IndexOutOfBoundsException voor ongeldige grenzen. ArrayList documenteert afzonderlijk IllegalArgumentException voor fromIndex > toIndex als beide grenswaarden binnen het toegestane bereik liggen.

De weergave blijft gekoppeld aan de oorspronkelijke lijst. Niet-structurele wijzigingen in het gekozen bereik, zoals het vervangen van een element met set als die bewerking wordt ondersteund, zijn in beide richtingen zichtbaar. De weergave ondersteunt dezelfde optionele bewerkingen als de oorspronkelijke lijst. Als clear wordt ondersteund, verwijdert list.subList(fromIndex, toIndex).clear() dat bereik uit de oorspronkelijke lijst.

Wordt de oorspronkelijke lijst structureel gewijzigd zonder gebruik te maken van de teruggegeven weergave, dan definieert het contract het gedrag van de weergave niet meer. Dit geldt voor wijzigingen in de lengte en andere wijzigingen die een lopende iteratie kunnen verstoren, ook buiten het gekozen bereik. Vertrouw niet op een ConcurrentModificationException. Maak vooraf new ArrayList<>(view) als je een onafhankelijke, wijzigbare lijst nodig hebt. Dit is een oppervlakkige kopie: de elementen zelf worden niet gekopieerd.

Voorbeelden

import java.util.ArrayList;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>(List.of("A", "B", "C", "D", "E", "F"));
        List<String> view = list.subList(2, 5);
        System.out.println(view);

        view.set(0, "X");
        list.set(3, "Y");
        System.out.println(list);
        System.out.println(view);

        List<String> copy = new ArrayList<>(view);
        view.clear();
        System.out.println(list);
        System.out.println(copy);
    }
}

Resultaat

[C, D, E]
[A, B, X, Y, E, F]
[X, Y, E]
[A, B, F]
[X, Y, E]

De weergave begint bij `C`, dus `view.set(0, "X")` vervangt het element op index 2 van de oorspronkelijke lijst. Daarna is `list.set(3, "Y")` zichtbaar in de weergave. Na `view.clear()` bevat de oorspronkelijke lijst `[A, B, F]`, terwijl de kopie `[X, Y, E]` behoudt.

Gerelateerde lessen

  • Java · Les 21 · Gevorderd · Versie: 2
  • Java · Les 57 · Gemiddeld · Versie: 2

Bronnen