CKTIS / Java
List.remove(Object): премахване на първото съвпадение
Премахни първото срещане на стойност, например име на абонат, и провери по резултата от тип `boolean` дали е премахнат елемент. Не бъркай стойност с индекс.
Версия: Java SE 21
Синтаксис
boolean remove(Object o); // remove by value
E remove(int index); // remove by zero-based indexList.remove(Object) променя самия списък. Методът премахва само елемента с най-малък индекс i, за който Objects.equals(o, get(i)) връща true. Следващите съвпадения остават. Ако извикването завърши без изключение, резултатът е true при премахнат елемент или false, когато няма съвпадение и списъкът остава непроменен. В unsubscribe аргументът от тип String е име, а не позиция.
Претовареният вариант remove(int index) премахва елемента на посочения индекс, броен от нула, и го връща като стойност от тип E. Невалиден индекс води до IndexOutOfBoundsException. При List<Integer> извикването numbers.remove(1) премахва елемента на индекс 1, а numbers.remove(Integer.valueOf(7)) премахва първото срещане на стойността 7. Компилаторът избира според типа на аргумента, а не според очаквания тип на резултата: предимство има вариантът, който не изисква boxing или unboxing.
Премахването е незадължителна операция. ArrayList я поддържа, но списък, получен чрез List.of(...), хвърля UnsupportedOperationException дори без съвпадение. В зависимост от реализацията премахването по стойност може да хвърли и ClassCastException при несъвместим тип или NullPointerException при null, ако списъкът не допуска null.
Примери
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);
}
}Резултат
true [Lin, Ada] false [Lin, Ada] 9 true [7]
Всяко `new ArrayList<>(List.of(...))` създава копие, което може да се променя. Първото `Ada` се премахва, второто остава, а липсата на `Sam` дава `false`. От списъка с числа първо се премахва `9` на индекс `1`, а после първото срещане на стойността `7`.
Свързани уроци
- Java · Урок 22 · Средно · Версия: 2
- Java · Урок 26 · Средно · Версия: 2