База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

List.remove(Object): премахване на първото съвпадение

Премахни първото срещане на стойност, например име на абонат, и провери по резултата от тип `boolean` дали е премахнат елемент. Не бъркай стойност с индекс.

Версия: Java SE 21

Синтаксис

boolean remove(Object o); // remove by value
E remove(int index);      // remove by zero-based index

List.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

Източници