List.addAll() 方法是 Java 中 List 接口提供的一个用于向一个 List 集合中添加另一个 List 集合中所有元素的方法。该方法可以方便地将一个 List 集合中的元素添加到另一个 List 集合中,从而使得代码变得更加简洁,功能更加优秀。
一、使用List.addAll方法的基本语法
public boolean addAll(Collection c)
上面是 List.addAll()
方法的基本语法,其中 Collection c
表示需要添加到 list 集合中的元素来源,该参数是一个 Collection 集合,也就是说, List.addAll()
方法的参数是一个 Collection 类型的参数。
List.addAll 方法遍历指定集合中的所有元素,并将它们逐个添加到调用该方法的列表的末尾。
它利用了列表的可变性质,通过修改列表本身来添加新的元素。
二、作用:
连接两个列表,将一个列表的所有元素添加到另一个列表的末尾。
从一个集合中添加多个元素到列表中。
注意事项:
.
添加的元素顺序与集合中元素的迭代顺序一致。 如果列表是有序的(如 ArrayList),则添加的元素将按照它们在集合中的顺序进行排列。
.
调用 addAll 方法会修改原始列表,将新元素添加到其末尾,而不创建一个新的列表对象。
.
如果集合中存在 null 元素,它们也会被添加到列表中。
.
注意避免出现循环引用的情况,比如在添加元素时不要将列表本身作为元素添加到自身中。
三、List.addAll方法的返回值
List.addAll() 方法的返回值为 boolean 类型,并且该返回值表示向集合中添加元素的操作是否成功。
如果该方法成功添加了新元素,返回值为 true;如果没有成功添加新元素,则返回值为 false。
四、使用List.addAll方法添加元素
我们通过 List.addAll() 方法可以方便地向一个 List 集合中添加另一个 List 集合中所有元素。下面是一个使用示例:
import java.util.ArrayList;
import java.util.List;
public class ListAddAllExample {
public static void main(String[] args) {
List list1 = new ArrayList<>();
list1.add("a");
list1.add("b");
List list2 = new ArrayList<>();
list2.add("c");
list2.add("d");
list1.addAll(list2);
System.out.println(list1);
}
}
输出结果为 [a, b, c, d]
。
当list中有空元素的时候,如下图所示。
五、使用List.addAll方法的注意事项
1、参数不能为空
List.addAll() 方法接受的参数不能为空,如果传入的参数为 null,那么该方法会抛出 NullPointerException 异常。
2、List集合的初始大小要足够
当 List.addAll() 方法被调用时,List 集合的大小会随之增加。因此,在使用该方法前,应确保 List 集合的大小足够容纳需要添加的元素。
3、List集合的元素类型必须与需要添加的元素类型相同
List.addAll() 方法不能添加不同类型的元素,如果尝试向 List 集合中添加不同类型的元素,则会抛出 ClassCastException 异常。
六、结语
本篇文章介绍了 List.addAll()
方法的基本语法、返回值、使用方法及注意事项。通过本文的介绍,相信大家已经对于该方法的使用有了一定的了解和掌握。