CKTIS / Java
List.add — een element toevoegen aan een lijst
`List.add(E)` voegt één element achteraan een lijst toe en geeft bij succes `true` terug. Met de overload met index voeg je een element op een gekozen positie in.
Versie: Java SE 21
Syntax
boolean add(E e)
void add(int index, E element)In Java SE 21 heeft de interface java.util.List<E> twee overloads van List.add. De methode met één argument, List.add(E), voegt een element toe aan het einde van de bestaande lijst. E is het elementtype, bijvoorbeeld String in List<String>. De volgorde van de bestaande elementen blijft behouden. Bij succes geeft de methode true terug, geen index of nieuwe lijst. ArrayList staat duplicaten en null-waarden toe.
De overload add(int index, E element) voegt een element in op een positie waarvan de telling bij nul begint en heeft retourtype void. Het element op die positie en alle volgende elementen schuiven één plaats naar rechts. Bij index == size() komt het element achteraan. Een index buiten 0 <= index && index <= size() is ongeldig en veroorzaakt een IndexOutOfBoundsException als invoegen wordt ondersteund. Anders dan set(index, element) vervangt invoegen geen element.
Toevoegen is optioneel: het type List<E> alleen garandeert niet dat een bepaalde lijst toevoegingen ondersteunt. Een niet-ondersteunde aanroep gooit een UnsupportedOperationException in plaats van false terug te geven. Een lijst die toevoegen ondersteunt, kan nog steeds null weigeren met een NullPointerException, een niet-toegestaan type met een ClassCastException of een niet-toegestane eigenschap van het element met een IllegalArgumentException.
List.of(...) maakt een lijst die niet gewijzigd kan worden. Arrays.asList(...) geeft een lijst terug die aan een array gekoppeld is: je kunt elementen vervangen, maar de grootte ligt vast. Geen van beide ondersteunt add. Heb je een aparte lijst nodig die kan groeien, gebruik dan new ArrayList<>(source). Een element achteraan de kopie toevoegen verandert de bronlijst niet.
Voorbeelden
import java.util.ArrayList;
import java.util.List;
public class Main {
public static void main(String[] args) {
List<String> source = List.of("alpha", "beta");
List<String> tags = new ArrayList<>(source);
boolean added = tags.add("alpha");
tags.add(1, "gamma");
System.out.println(added);
System.out.println(tags);
System.out.println(source);
try {
source.add("delta");
} catch (UnsupportedOperationException e) {
System.out.println("UnsupportedOperationException");
}
}
}Resultaat
true [alpha, gamma, beta, alpha] [alpha, beta] UnsupportedOperationException
Een tweede `alpha` achteraan `tags` toevoegen geeft `true` terug. Door `gamma` op index `1` in te voegen, schuiven `beta` en de tweede `alpha` naar rechts. `source` blijft ongewijzigd en weigert de poging om `delta` toe te voegen.
Gerelateerde lessen
- Java · Les 1 · Gevorderd · Versie: 2
- Java · Les 2 · Gevorderd · Versie: 2
- Java · Les 6 · Gevorderd · Versie: 2
- Java · Les 8 · Gevorderd · Versie: 2
- Java · Les 10 · Gevorderd · Versie: 2
- Java · Les 13 · Gevorderd · Versie: 2
- Java · Les 21 · Gevorderd · Versie: 2
- Java · Les 33 · Gevorderd · Versie: 2
- Java · Les 35 · Gevorderd · Versie: 2
- Java · Les 36 · Gevorderd · Versie: 2
- Java · Les 38 · Gevorderd · Versie: 2
- Java · Les 19 · Basis · Versie: 2
- Java · Les 29 · Basis · Versie: 2
- Java · Les 39 · Basis · Versie: 2
- Java · Les 44 · Basis · Versie: 2
- Java · Les 54 · Basis · Versie: 2
- Java · Les 57 · Basis · Versie: 2
- Java · Les 59 · Basis · Versie: 2
- Java · Les 62 · Basis · Versie: 2
- Java · Les 2 · Gemiddeld · Versie: 2
- Java · Les 5 · Gemiddeld · Versie: 2
- Java · Les 6 · Gemiddeld · Versie: 2
- Java · Les 33 · Gemiddeld · Versie: 2
- Java · Les 34 · Gemiddeld · Versie: 2
- Java · Les 36 · Gemiddeld · Versie: 2
- Java · Les 39 · Gemiddeld · Versie: 2
- Java · Les 50 · Gemiddeld · Versie: 2