Collection.remove()

从该集合中移除指定元素的单个实例, 如果它存在的话.

定义

boolean remove​(Object o)

参数

参数类型参数名称参数描述
Objecto要删除的集合对象
类型参数E集合元素的类型

返回值

是否成功从集合中删除元素, 若集合包含该元素则返回 true, 否则返回 false .

抛出的异常

UnsupportedOperationException 如果集合不支持删除操作

ClassCastException 如果指定元素的类型与此集合不兼容

NullPointerException 如果指定的元素为 null 且当前集合不允许 null 元素

说明

更正式地说, 删除一个元素 e 如果集合包含一个或多个这样的元素使得 Objects.equals(o, e) 成立, 那么当前集合包含了指定的元素, 则返回 true, 这也等同于如果当前集合因调用了本方法而发生更改, 则返回 true.

注意事项

当按元素删除且集合中包含多个相同元素时, remove() 方法会删除第一个遇到的元素并返回 true.

示例

从集合中删除元素的示例

package com.yi21.collection;

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

public class Yi21CollectionRemove {

    public static void main(String[] args) {
        

        List<String> list = new ArrayList<>();
        list.addAll(List.of("Hello", "Wolrd", "21yi"));
        System.out.println("对象 list 是否是一个集合? " + (list instanceof Collection));

        String term = "31yi";
        System.out.println("是否成功删除 " + term + " ? " + list.remove(term));

        term = "21yi";
        System.out.println("是否成功删除 " + term + " ? " + list.remove(term));

    }

}

执行结果为 :

对象 list 是否是一个集合? true
是否成功删除 31yi ?false
是否成功删除 21yi ?true