CKTIS / Java
List.remove(Object): odstranjevanje prvega ujemanja
Odstrani prvo pojavitev vrednosti, na primer imena naročnika, in z rezultatom tipa `boolean` preveri, ali je bil element odstranjen. Vrednosti ne zamenjaj z indeksom.
Različica: Java SE 21
Sintaksa
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) spremeni sam seznam. Odstrani samo element z najmanjšim indeksom i, za katerega Objects.equals(o, get(i)) vrne true. Poznejša ujemanja ostanejo. Če se klic konča brez izjeme, vrne true, če je bil element odstranjen, ali false, če ujemanja ni bilo in je seznam ostal nespremenjen. V metodi unsubscribe je argument tipa String ime, ne položaj.
Preobremenjena različica remove(int index) odstrani element na podanem indeksu, štetem od nič, in ga vrne kot vrednost tipa E. Neveljaven indeks sproži IndexOutOfBoundsException. Pri List<Integer> klic numbers.remove(1) odstrani element na indeksu 1, klic numbers.remove(Integer.valueOf(7)) pa prvo pojavitev vrednosti 7. Prevajalnik izbere različico glede na tip argumenta, ne glede na pričakovani tip rezultata: prednost ima različica, ki ne zahteva boxinga ali unboxinga.
Odstranjevanje je neobvezna operacija. ArrayList jo podpira, seznam iz List.of(...) pa sproži UnsupportedOperationException tudi brez ujemanja. Odvisno od implementacije lahko odstranjevanje po vrednosti sproži tudi ClassCastException pri nezdružljivem tipu ali NullPointerException pri null, če seznam ne dovoljuje vrednosti null.
Primeri
import java.util.ArrayList;
import java.util.List;
public class Main {
static boolean unsubscribe(List<String> names, String name) {
return names.remove(name);
}
public static void main(String[] args) {
List<String> names = new ArrayList<>(List.of("Ada", "Lin", "Ada"));
System.out.println(unsubscribe(names, "Ada"));
System.out.println(names);
System.out.println(unsubscribe(names, "Sam"));
System.out.println(names);
List<Integer> numbers = new ArrayList<>(List.of(7, 9, 7));
System.out.println(numbers.remove(1));
System.out.println(numbers.remove(Integer.valueOf(7)));
System.out.println(numbers);
}
}Rezultat
true [Lin, Ada] false [Lin, Ada] 9 true [7]
Vsak `new ArrayList<>(List.of(...))` ustvari spremenljivo kopijo. Prvi `Ada` se odstrani, drugi ostane, ker pa `Sam` manjka, je rezultat `false`. S seznama števil se najprej odstrani `9` na indeksu `1`, nato prva pojavitev vrednosti `7`.
Povezane lekcije
- Java · Lekcija 22 · Srednja · Različica: 2
- Java · Lekcija 26 · Srednja · Različica: 2