方法详细信息
size int size()
返回此列表中的元素数。
如果此列表包含超过Integer.MAX_VALUE元素，则返回Integer.MAX_VALUE 。
Specified by:
size in interface
Collection
结果
此列表中的元素数量
isEmpty boolean isEmpty()
如果此列表不包含任何元素，则返回
true 。
Specified by:
isEmpty在界面
Collection
结果
true如果此列表不包含任何元素
contains boolean contains(Object o)
如果此列表包含指定的元素，则返回true 。
更正式地说，返回true当且仅当此列表包含至少一个元素e ，使得Objects.equals(o, e) 。
Specified by:
contains在界面
Collection
参数
o - 要测试其在此列表中的存在的元素
结果
true如果此列表包含指定的元素
异常
ClassCastException - 如果指定元素的类型与此列表不兼容（
optional ）
NullPointerException - 如果指定的元素为null且此列表不允许null元素（
optional ）
iterator Iterator
以适当的顺序返回此列表中元素的迭代器。
Specified by:
iterator在界面
Collection
Specified by:
iterator在界面
Iterable
结果
以适当的顺序在此列表中的元素上的迭代器
toArray Object[] toArray()
以适当的顺序（从第一个元素到最后一个元素）返回包含此列表中所有元素的数组。
返回的数组将是“安全的”，因为此列表不会保留对它的引用。 （换句话说，即使此列表由数组支持，此方法也必须分配新数组）。 因此调用者可以自由修改返回的数组。
此方法充当基于阵列和基于集合的API之间的桥梁。
Specified by:
toArray在界面
Collection
结果
一个数组，以适当的顺序包含此列表中的所有元素
另请参见：
Arrays.asList(Object[])
toArray
以适当的顺序返回包含此列表中所有元素的数组（从第一个元素到最后一个元素）;
返回数组的运行时类型是指定数组的运行时类型。
如果列表适合指定的数组，则返回其中。
否则，将为新数组分配指定数组的运行时类型和此列表的大小。
如果列表适合指定的数组，并且有空余空间（即，数组的元素多于列表），则紧跟在列表末尾之后的数组中的元素将设置为null 。 （ 仅当调用者知道列表不包含任何null元素时，这在确定列表长度时很有用。）
与toArray()方法一样，此方法充当基于阵列和基于集合的API之间的桥梁。 此外，该方法允许精确控制输出阵列的运行时类型，并且在某些情况下可以用于节省分配成本。
假设x是已知仅包含字符串的列表。 以下代码可用于将列表转储到新分配的String数组中：
String[] y = x.toArray(new String[0]);
请注意， toArray(new Object[0])功能与toArray()相同。
Specified by:
toArray在界面
Collection
参数类型
T - 要包含集合的数组的组件类型
参数
a - 要存储此列表元素的数组（如果足够大）;
否则，为此目的分配相同运行时类型的新数组。
结果
包含此列表元素的数组
异常
ArrayStoreException - 如果指定数组的运行时类型不是此列表中每个元素的运行时类型的超类型
NullPointerException - 如果指定的数组为null
add boolean add(E e)
将指定的元素追加到此列表的末尾（可选操作）。
支持此操作的列表可能会限制可能添加到此列表的元素。 特别是，某些列表将拒绝添加null元素，而其他列表将对可能添加的元素类型施加限制。 列表类应在其文档中明确指出可以添加哪些元素的任何限制。
Specified by:
add在界面
Collection
参数
e - 要附加到此列表的元素
结果
true （由
Collection.add(E)指定）
异常
UnsupportedOperationException - 如果此列表不支持
add操作
ClassCastException - 如果指定元素的类阻止将其添加到此列表中
NullPointerException - 如果指定的元素为null且此列表不允许null元素
IllegalArgumentException - 如果此元素的某些属性阻止将其添加到此列表中
remove boolean remove(Object o)
从该列表中删除指定元素的第一个匹配项（如果存在）（可选操作）。
如果此列表不包含该元素，则不会更改。
更正式地，删除具有最低索引i的元素，使得Objects.equals(o, get(i)) （如果存在这样的元素）。
如果此列表包含指定的元素，则返回true （或等效地，如果此列表因调用而更改）。
Specified by:
remove在界面
Collection
参数
o - 要从此列表中删除的元素（如果存在）
结果
true如果此列表包含指定的元素
异常
ClassCastException - 如果指定元素的类型与此列表不兼容（
optional ）
NullPointerException - 如果指定的元素为null且此列表不允许null元素（
optional ）
UnsupportedOperationException - 如果此列表不支持
remove操作
containsAll boolean containsAll(Collection c)
如果此列表包含指定集合的所有元素，则返回
true 。
Specified by:
containsAll在界面
Collection
参数
c - 要在此列表中检查包含的集合
结果
true如果此列表包含指定集合的所有元素
异常
ClassCastException - 如果指定集合中的一个或多个元素的类型与此列表不兼容（
optional ）
NullPointerException - 如果指定的集合包含一个或多个null元素，并且此列表不允许null元素（
optional ），或者指定的集合为null
另请参见：
contains(Object)
addAll boolean addAll(Collection c)
将指定集合中的所有元素按指定集合的迭代器（可选操作）返回的顺序追加到此列表的末尾。
如果在操作正在进行时修改了指定的集合，则此操作的行为是不确定的。
（请注意，如果指定的集合是此列表，则会发生这种情况，并且它是非空的。）
Specified by:
addAll在界面
Collection
参数
c - 包含要添加到此列表的元素的集合
结果
true如果此列表因呼叫而更改
异常
UnsupportedOperationException - 如果此列表不支持
addAll操作
ClassCastException - 如果指定集合的元素的类阻止将其添加到此列表中
NullPointerException - 如果指定的集合包含一个或多个null元素，并且此列表不允许null元素，或者指定的集合为null
IllegalArgumentException - 如果指定集合的某个元素的某些属性阻止将其添加到此列表中
另请参见：
add(Object)
addAll boolean addAll(int index,
Collection c)
将指定集合中的所有元素插入到指定位置的此列表中（可选操作）。
将当前位置的元素（如果有）和任何后续元素向右移动（增加其索引）。
新元素将按照指定集合的迭代器返回的顺序出现在此列表中。
如果在操作正在进行时修改了指定的集合，则此操作的行为是不确定的。
（请注意，如果指定的集合是此列表，则会发生这种情况，并且它是非空的。）
参数
index - 从指定集合插入第一个元素的索引
c - 包含要添加到此列表的元素的集合
结果
true如果此列表因呼叫而更改
异常
UnsupportedOperationException - 如果此列表不支持
addAll
ClassCastException - 如果指定集合的元素的类阻止将其添加到此列表中
NullPointerException - 如果指定的集合包含一个或多个null元素，并且此列表不允许null元素，或者指定的集合为null
IllegalArgumentException - 如果指定集合的元素的某些属性阻止将其添加到此列表中
IndexOutOfBoundsException - 如果指数超出范围（
index < 0 || index > size() ）
removeAll boolean removeAll(Collection c)
从此列表中删除指定集合中包含的所有元素（可选操作）。
Specified by:
removeAll在界面
Collection
参数
c - 包含要从此列表中删除的元素的集合
结果
true如果此列表因呼叫而更改
异常
UnsupportedOperationException - 如果此列表不支持
removeAll操作
ClassCastException - 如果此列表的元素的类与指定的集合不兼容（
optional ）
NullPointerException - 如果此列表包含null元素且指定的集合不允许null元素（
optional ），或者指定的集合为null
另请参见：
remove(Object) ，
contains(Object)
retainAll boolean retainAll(Collection c)
仅保留此列表中包含在指定集合中的元素（可选操作）。
换句话说，从该列表中删除未包含在指定集合中的所有元素。
Specified by:
retainAll在界面
Collection
参数
c - 包含要在此列表中保留的元素的集合
结果
true如果此列表因呼叫而更改
异常
UnsupportedOperationException - 如果此列表不支持
retainAll
ClassCastException - 如果此列表的元素的类与指定的集合不兼容（
optional ）
NullPointerException - 如果此列表包含null元素且指定的集合不允许null元素（
optional ），或者指定的集合为null
另请参见：
remove(Object) ，
contains(Object)
replaceAll default void replaceAll(UnaryOperator
将该列表的每个元素替换为将运算符应用于该元素的结果。
操作员抛出的错误或运行时异常将转发给调用者。
实现要求：
对于此list ，默认实现等效于：
final ListIterator
如果列表的list-iterator不支持set操作，则在替换第一个元素时将抛出UnsupportedOperationException 。
参数
operator - 要应用于每个元素的运算符
异常
UnsupportedOperationException - 如果此列表不可修改。
如果无法替换元素或者通常不支持修改，则实现可能会抛出此异常
NullPointerException - 如果指定的运算符为null或运算符结果为空值且此列表不允许null元素（
optional ）
从以下版本开始：
1.8
sort default void sort(Comparator c)
根据指定的Comparator引发的顺序对此列表进行排序。
排序是稳定的 ：此方法不得重新排序相同的元素。
此列表中的所有元素必须使用指定的比较器相互比较（即c.compare(e1, e2)不得为ClassCastException中的任何元素e1和e2抛出ClassCastException ）。
如果指定的比较器为null则此列表中的所有元素必须实现Comparable接口，并且应使用元素' natural ordering 。
此列表必须是可修改的，但无需调整大小。
实现要求：
默认实现获取包含此列表中所有元素的数组，对数组进行排序，并迭代此列表，从数组中的相应位置重置每个元素。
（这样可以避免尝试对链接列表进行排序所导致的n 2 log（n）性能。）
Implementation Note:
此实现是一个稳定的，自适应的迭代合并输出，当输入数组被部分排序时，它需要远远少于n lg（n）的比较，同时在输入数组随机排序时提供传统合并输出的性能。
如果输入数组几乎排序，则实现需要大约n次比较。
临时存储要求从几乎排序的输入数组的小常量到随机排序的输入数组的n / 2个对象引用不等。
该实现在其输入数组中具有升序和降序的相同优势，并且可以利用同一输入数组的不同部分中的升序和降序。 它非常适合合并两个或多个排序数组：只需连接数组并对结果数组进行排序。
该实现改编自Tim Peters的Python排序（ TimSort ）。 它使用了Peter McIlroy的“乐观排序和信息理论复杂性”中的技术，参见“第四届年度ACM-SIAM离散算法研讨会论文集”，第467-474页，1993年1月。
参数
c - 用于比较列表元素的Comparator 。
null值表示应使用元素' natural ordering
异常
ClassCastException - 如果列表包含使用指定比较器无法
相互比较的元素
UnsupportedOperationException - 如果列表的list-iterator不支持
set操作
IllegalArgumentException - （ optional ）若发现比较器有违反Comparator的合约
从以下版本开始：
1.8
clear void clear()
从此列表中删除所有元素（可选操作）。
此调用返回后，列表将为空。
Specified by:
clear在界面
Collection
异常
UnsupportedOperationException - 如果此列表不支持
clear
equals boolean equals(Object o)
将指定对象与此列表进行比较以获得相等性。
当且仅当指定的对象也是列表时，返回true ，两个列表具有相同的大小，并且两个列表中的所有对应元素对都相等 。
（两个元件e1和e2是如果相等 Objects.equals(e1, e2) ）。换句话说，两个列表被定义为等于如果它们包含以相同的顺序相同的元件。
此定义确保equals方法在List接口的不同实现中正常工作。
Specified by:
equals在界面
Collection
重写：
equals类
Object
参数
o - 要与此列表进行相等性比较的对象
结果
true如果指定的对象等于此列表
另请参见：
Object.hashCode() ， HashMap
hashCode int hashCode()
返回此列表的哈希码值。
列表的哈希码被定义为以下计算的结果：
int hashCode = 1; for (E e : list) hashCode = 31*hashCode + (e==null ? 0 : e.hashCode());
这确保list1.equals(list2)暗示list1.hashCode()==list2.hashCode()对于任何两个列表， list1和list2 ，根据list2的一般合同的要求 。
Specified by:
hashCode在界面
Collection
重写：
hashCode在类
Object
结果
此列表的哈希码值
另请参见：
Object.equals(Object) ，
equals(Object)
get E get(int index)
返回此列表中指定位置的元素。
参数
index - 要返回的元素的索引
结果
此列表中指定位置的元素
异常
IndexOutOfBoundsException - 如果指数超出范围（
index < 0 || index >= size() ）
set E set(int index,
E element)
用指定的元素替换此列表中指定位置的元素（可选操作）。
参数
index - 要替换的元素的索引
element - 要存储在指定位置的元素
结果
先前在指定位置的元素
异常
UnsupportedOperationException - 如果此列表不支持
set操作
ClassCastException - 如果指定元素的类阻止将其添加到此列表中
NullPointerException - 如果指定的元素为null且此列表不允许null元素
IllegalArgumentException - 如果指定元素的某些属性阻止将其添加到此列表中
IndexOutOfBoundsException - 若索引超出范围（
index < 0 || index >= size() ）
add void add(int index,
E element)
将指定元素插入此列表中的指定位置（可选操作）。
将当前位置的元素（如果有）和任何后续元素向右移动（将其添加到索引中）。
参数
index - 要插入指定元素的索引
element - 要插入的元素
异常
UnsupportedOperationException - 如果此列表不支持
add操作
ClassCastException - 如果指定元素的类阻止将其添加到此列表中
NullPointerException - 如果指定的元素为null，并且此列表不允许null元素
IllegalArgumentException - 如果指定元素的某些属性阻止将其添加到此列表中
IndexOutOfBoundsException - 如果指数超出范围（
index < 0 || index > size() ）
remove E remove(int index)
删除此列表中指定位置的元素（可选操作）。
将任何后续元素向左移位（从索引中减去一个元素）。
返回从列表中删除的元素。
参数
index - 要删除的元素的索引
结果
先前在指定位置的元素
异常
UnsupportedOperationException - 如果此列表不支持
remove操作
IndexOutOfBoundsException - 如果索引超出范围（
index < 0 || index >= size() ）
indexOf int indexOf(Object o)
返回此列表中第一次出现的指定元素的索引，如果此列表不包含该元素，则返回-1。
更正式的是，返回最低指数i如Objects.equals(o, get(i)) ，如果没有这样的指数则返回-1。
参数
o - 要搜索的元素
结果
此列表中第一次出现的指定元素的索引，如果此列表不包含该元素，则返回-1
异常
ClassCastException - 如果指定元素的类型与此列表不兼容（
optional ）
NullPointerException - 如果指定的元素为null且此列表不允许null元素（
optional ）
lastIndexOf int lastIndexOf(Object o)
返回此列表中指定元素最后一次出现的索引，如果此列表不包含该元素，则返回-1。
更正式的是，返回最高指数i如Objects.equals(o, get(i)) ，如果没有这样的指数则为-1。
参数
o - 要搜索的元素
结果
此列表中指定元素最后一次出现的索引，如果此列表不包含该元素，则返回-1
异常
ClassCastException - 如果指定元素的类型与此列表不兼容（
optional ）
NullPointerException - 如果指定的元素为null且此列表不允许null元素（
optional ）
listIterator ListIterator
返回此列表中元素的列表迭代器（按适当顺序）。
结果
列表中的元素列表迭代器（按正确顺序）
listIterator ListIterator
从列表中的指定位置开始，返回列表中元素的列表迭代器（按正确顺序）。
指定的索引指示初始调用next将返回的第一个元素。
对previous的初始调用将返回指定索引减去1的元素。
参数
index - 从列表迭代器返回的第一个元素的索引（通过调用
next ）
结果
列表中元素的列表迭代器（按正确顺序），从列表中的指定位置开始
异常
IndexOutOfBoundsException - 若索引超出范围（
index < 0 || index > size() ）
subList List
int toIndex)
返回指定的fromIndex （包含）和toIndex （不包括）之间的此列表部分的视图。
（如果fromIndex和toIndex相等，则返回的列表为空。）返回的列表由此列表支持，因此返回列表中的非结构更改将反映在此列表中，反之亦然。
返回的列表支持此列表支持的所有可选列表操作。
此方法消除了对显式范围操作的需要（对于数组通常存在的排序）。 任何需要列表的操作都可以通过传递subList视图而不是整个列表来用作范围操作。 例如，以下习语从列表中删除了一系列元素：
list.subList(from, to).clear();
可以为indexOf和lastIndexOf构造类似的习语，并且可以将Collections类中的所有算法应用于子列表。
如果支持列表（即此列表）在结构上以除返回列表之外的任何方式进行变量 ，则此方法返回的列表的语义将变为未定义。 （结构修改是那些改变了这个列表的大小，或以其他方式扰乱它的方式，正在进行的迭代可能会产生不正确的结果。）
参数
fromIndex -
fromIndex低端点（包括）
toIndex -
toIndex高端点（不包括）
结果
此列表中指定范围的视图
异常
IndexOutOfBoundsException - 用于非法端点索引值（
fromIndex < 0 || toIndex > size || fromIndex > toIndex ）
spliterator default Spliterator
在此列表中的元素上创建Spliterator 。
Spliterator报告Spliterator.SIZED和Spliterator.ORDERED 。 实施应记录其他特征值的报告。
Specified by:
spliterator在界面
Collection
Specified by:
spliterator在界面
Iterable
实现要求：
默认实现创建一个late-binding spliterator，如下所示：
如果列表是RandomAccess的实例，则默认实现会创建一个通过调用方法get(int)遍历元素的spliterator 。 如果这样的调用导致或将导致IndexOutOfBoundsException那么分裂器将快速失败并抛出ConcurrentModificationException 。 如果列表也是AbstractList的实例，则spliterator将使用列表的modCount字段来提供其他快速失败行为。
否则，默认实现从列表的Iterator创建一个Iterator 。 spliterator继承了列表迭代器的fail-fast 。
Implementation Note:
创建的
Spliterator另外报告
Spliterator.SUBSIZED 。
结果
这个列表中的元素是
Spliterator
从以下版本开始：
1.8
of static
返回包含零元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
结果
空
List
从以下版本开始：
9
of static
返回包含一个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 单个元素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2)
返回包含两个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3)
返回包含三个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
e3 - 第三个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4)
返回包含四个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个元素
e3 - 第三个要素
e4 - 第四个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4,
E e5)
返回包含五个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个元素
e3 - 第三个要素
e4 - 第四个要素
e5 - 第五个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4,
E e5,
E e6)
返回包含六个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
e3 - 第三个要素
e4 - 第四个要素
e5 - 第五个要素
e6 - 第六个元素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4,
E e5,
E e6,
E e7)
返回包含七个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
e3 - 第三个要素
e4 - 第四个要素
e5 - 第五个要素
e6 - 第六个元素
e7 - 第七个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4,
E e5,
E e6,
E e7,
E e8)
返回包含八个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
e3 - 第三个要素
e4 - 第四个要素
e5 - 第五个要素
e6 - 第六个元素
e7 - 第七个要素
e8 - 第八个元素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4,
E e5,
E e6,
E e7,
E e8,
E e9)
返回包含九个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
e3 - 第三个要素
e4 - 第四个要素
e5 - 第五个要素
e6 - 第六个要素
e7 - 第七个元素
e8 - 第八个元素
e9 - 第九个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of static
E e2,
E e3,
E e4,
E e5,
E e6,
E e7,
E e8,
E e9,
E e10)
返回包含十个元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
参数类型
E -
List的元素类型
参数
e1 - 第一个元素
e2 - 第二个要素
e3 - 第三个要素
e4 - 第四个要素
e5 - 第五个要素
e6 - 第六个要素
e7 - 第七个要素
e8 - 第八个元素
e9 - 第九个要素
e10 - 第十个要素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null
从以下版本开始：
9
of @SafeVarargs
static
返回包含任意数量元素的不可修改列表。
有关详细信息，请参见Unmodifiable Lists 。
API Note:
此方法还接受单个数组作为参数。
结果列表的元素类型将是数组的组件类型，列表的大小将等于数组的长度。
要使用作为数组的单个元素创建列表，请执行以下操作：
String[] array = ... ; List
这将导致调用List.of(E)方法。
参数类型
E -
List的元素类型
参数
elements - 列表中包含的元素
结果
包含指定元素的
List
异常
NullPointerException - 如果元素是
null或者数组是
null
从以下版本开始：
9
copyOf static
以迭代顺序返回包含给定Collection的元素的unmodifiable List 。
给定的Collection不能为null，并且不能包含任何null元素。
如果随后修改了给定的Collection，则返回的List将不会反映此类修改。
Implementation Note:
如果给定的Collection是
unmodifiable List ，则调用copyOf通常不会创建副本。
参数类型
E -
List的元素类型
参数
coll -
Collection绘制元素的
Collection必须为非null
结果
List包含给定
Collection的元素
异常
NullPointerException - 如果coll为null，或者它包含任何空值
从以下版本开始：
10
！