List

add

boolean add (E e)

将指定的元素附加到此列表的末尾（可选操作）。

支持此操作的列表可能会限制可以将哪些元素添加到此列表中。 特别是，一些列表将拒绝添加空元素，而其他列表将对可能添加的元素的类型施加限制。 列表类应在其文档中明确指定可添加元素的任何限制。

add

void add (int index, 
                E element)

将指定元素插入此列表中的指定位置（可选操作）。 将当前位置的元素（如果有的话）和任何后续元素移到右侧（将其中的一个添加到它们的索引）。

addAll

boolean addAll (Collection<? extends E> c)

按指定集合的迭代器（可选操作）返回的顺序，将指定集合中的所有元素追加到此列表的末尾。 如果在操作过程中修改了指定的集合，则此操作的行为未定义。 （请注意，如果指定的集合是这个列表，并且它是非空的，则会发生这种情况。）

addAll

boolean addAll (int index, 
                Collection<? extends E> c)

将指定集合中的所有元素插入指定位置的此列表中（可选操作）。 将当前在该位置的元素（如果有的话）和随后的元素移到右侧（增加它们的索引）。 新元素将按照它们由指定集合的迭代器返回的顺序出现在此列表中。 如果在操作过程中修改了指定的集合，则此操作的行为未定义。 （请注意，如果指定的集合是这个列表，并且它是非空的，则会发生这种情况。）

clear

void clear ()

从此列表中删除所有元素（可选操作）。 此通话返回后，该列表将为空。

contains

boolean contains (Object o)

如果此列表包含指定的元素，则返回true 。 更正式地，返回true当且仅当该列表包含至少一个元素e，例如(o==null ? e==null : o.equals(e)) 。

containsAll

boolean containsAll (Collection<?> c)

如果此列表包含指定集合的所有元素，则返回 true 。

equals

boolean equals (Object o)

将指定的对象与此列表进行比较以获得相等性。 当且仅当指定的对象也是一个列表时，返回true ，两个列表具有相同的大小，并且两个列表中的所有相应元素对都相等 。 （两个元件e1 e2和如果是等于 (e1==null ? e2==null : e1.equals(e2))）。换句话说，两个列表被定义为等于如果它们包含以相同的顺序相同的元件。 这个定义确保了equals方法在List接口的不同实现中正常工作。

get

E get (int index)

返回此列表中指定位置的元素。

hashCode

int hashCode ()

返回此列表的哈希码值。 列表的哈希码被定义为以下计算的结果：

  int hashCode = 1;
  for (E e : list)
      hashCode = 31*hashCode + (e==null ? 0 : e.hashCode());
 

indexOf

int indexOf (Object o)

返回此列表中指定元素第一次出现的索引，如果此列表不包含元素，则返回-1。 更正式地说，返回最低索引i，例如(o==null ? get(i)==null : o.equals(get(i))) ，如果没有这样的索引，则返回-1。

isEmpty

boolean isEmpty ()

如果此列表不包含任何元素，则返回 true 。

iterator

Iterator<E> iterator ()

以适当的顺序返回此列表中元素的迭代器。

lastIndexOf

int lastIndexOf (Object o)

返回此列表中指定元素的最后一次出现的索引，如果此列表不包含元素，则返回-1。 更正式地说，返回最高索引i，例如(o==null ? get(i)==null : o.equals(get(i))) ，如果没有这样的索引，则返回-1。

listIterator

ListIterator<E> listIterator (int index)

从列表中的指定位置开始，返回此列表中元素的列表迭代器（以正确的顺序）。 指定的索引指示将通过初始调用返回到next的第一个元素。 初始调用previous将返回指定索引减1的元素。

listIterator

ListIterator<E> listIterator ()

返回此列表中元素的列表迭代器（按适当顺序）。

remove

E remove (int index)

删除此列表中指定位置的元素（可选操作）。 将任何随后的元素向左移（从其索引中减去一个元素）。 返回从列表中移除的元素。

remove

boolean remove (Object o)

从列表中删除第一次出现的指定元素（如果存在）（可选操作）。 如果该列表不包含该元素，则不变。 更正式地说，删除索引最低的元素i ，使得(o==null ? get(i)==null : o.equals(get(i))) （如果存在这样的元素）。 如果此列表包含指定的元素（或等同地，如果此列表因呼叫而改变），则返回true 。

removeAll

boolean removeAll (Collection<?> c)

从此列表中删除指定集合中包含的所有元素（可选操作）。

replaceAll

void replaceAll (UnaryOperator<E> operator)

用将运算符应用于该元素的结果替换此列表中的每个元素。 由操作员抛出的错误或运行时异常会传递给调用者。

retainAll

boolean retainAll (Collection<?> c)

仅保留指定集合中包含的此列表中的元素（可选操作）。 换句话说，从该列表中删除所有未包含在指定集合中的元素。

set

E set (int index, 
                E element)

用指定的元素替换此列表中指定位置的元素（可选操作）。

size

int size ()

返回此列表中元素的数量。 如果此列表包含多个Integer.MAX_VALUE元素，则返回Integer.MAX_VALUE 。

sort

void sort (Comparator<? super E> c)

使用提供的 Comparator对此列表进行排序以比较元素。

subList

List<E> subList (int fromIndex, 
                int toIndex)

返回指定的fromIndex （含）和toIndex之间的此列表部分的视图，不包括。 （如果fromIndex和toIndex相等，则返回的列表为空。）返回的列表由此列表支持，因此返回列表中的非结构更改将反映在此列表中，反之亦然。 返回的列表支持此列表支持的所有可选列表操作。

此方法消除了对显式范围操作（数组通常存在的那种操作）的需要。 任何需要列表的操作都可以通过传递子列表视图而不是整个列表来用作范围操作。 例如，下面的习语从列表中删除了一系列元素：

      list.subList(from, to).clear();
 

如果支持列表（即此列表）在结构上以非返回列表的方式进行了修改 ，则此方法返回的列表的语义变得未定义。 （结构修改是那些改变这个列表的大小，或者以这样一种方式干扰它，以致正在进行的迭代可能产生不正确的结果。）

toArray

Object[] toArray ()

以适当的顺序返回一个包含此列表中所有元素的数组（从第一个元素到最后一个元素）。

返回的数组将是“安全的”，因为此列表不会保留对它的引用。 （换句话说，即使列表由数组支持，该方法也必须分配一个新数组）。 调用者可以自由修改返回的数组。

此方法充当基于数组和基于集合的API之间的桥梁。

toArray

T[] toArray (T[] a)

以正确的顺序返回一个包含此列表中所有元素的数组（从第一个元素到最后一个元素）; 返回数组的运行时类型是指定数组的运行时类型。 如果列表符合指定的数组，则返回其中。 否则，将使用指定数组的运行时类型和此列表的大小分配一个新数组。

如果列表符合指定的数组并且有空余空间（即数组的元素多于列表），紧接列表结尾的数组中的元素设置为null 。 （ 仅当调用者知道列表不包含任何空元素时，这对确定列表的长度很有用。）

与toArray()方法一样，此方法充当基于阵列和基于集合的API之间的桥梁。 此外，该方法允许精确控制输出数组的运行时类型，并且在某些情况下可以用于节省分配成本。

假设x是已知只包含字符串的列表。 以下代码可用于将列表转储到新分配的String数组中：

     String[] y = x.toArray(new String[0]);