接上两篇文章《Java源码 java.util.List接口学习记录(一)》、《Java源码 java.util.List接口学习记录(二)》,本文章将继续翻译说明List接口最后的八种方法。
21、add
void add(int index, E element):
在list的指定位置(index)出插入指定的元素。移动当前那个位置的元素,随后的元素也向右移动。
index:index是指指定元素被插入在哪个位置
element:被插入的元素
异常:
UnsupportedOperationException: 如果addAll这个操作不被这个list允许
ClassCastException: 如果这个元素的类阻止它被插入到这个list中
NullPointerException: 如果指定元素为null,这个list不允许null元素
IllegalArgumentException: 如果这个元素的某些特性阻止它被添加到这个list中
IndexOutOfBoundsException: 如果索引超出范围。(比如index<0||index>size())
22、remove
E remove(int index):
移除list中指定位置(index)的元素,向左移动随后的所有元素,返回被移除的的元素
index:index是指 哪个位置上的元素被移除
异常:
UnsupportedOperationException: 如果移除操作不被这个list允许
IndexOutOfBoundsException: 如果index超过范围(index<0||index>size())
23、indexOf
int indexOf(Object o):
返回指定元素在这个list中第一次被发现时的下标,如果这个list不包含这个元素返回-1。
O :查询的那个元素
异常:
ClassCastException:如果这个指定元素的类型与这个list相矛盾
NullPointerException:如果这个指定元素为null,并且这个list不允许null元素
24、lasIndexOf
int lasIndexOf(Object o):
返回指定元素在这个list中最后被发现时的下标,如果这个list不包含这个元素返回-1。
O :查询的那个元素
异常:
ClassCastException:如果这个指定元素的类型与这个list相矛盾
NullPointerException:如果这个指定元素为null,并且这个list不允许null元素
25、listIterator
ListIterator listIterator():
返回列表中所有元素的列表迭代器
26、listIterator
ListIterator listIterator(int index):
返回列表中所有元素的列表迭代器,起始位置为指定位置。指定的索引指示对next的初始调用将返回的第一个元素。对previous的初始调用将返回指定索引为 -1的元素。
异常:
IndexOutOfBoundsException:下标越界(index<0||index >size())
27、sublist
List subList(int fromIndex, int toIndex):
返回list的下标从formindex(包含)到toindex(不包含)之间的元素(如果formindex和toindex相同,返回的list为空)。
返回的list由该list支持,因此返回list中的非结构化更改反映在该list中,反之亦然。返回的list支持该list支持的所有可选list操作。
这个方法不需要显式的范围操作(数组通常存在的那种操作)。任何需要列表的操作都可以通过传递子列表视图而不是整个列表来作为范围操作。例如,下面的习惯用法从列表中删除一系列元素:
list.subList(from, to).clear();
异常:
IndexOutOfBoundsException:为非法端点索引值(fromIndex < 0 || toIndex > size || fromIndex > toIndex)
28、spliterator
default Spliterator spliterator():
在列表中的元素上创建一个拆分器。
Spliterator报告Spliterator.size和Spliterator.ORDERED。实现应记录额外特征值的报告。
开始于1.8版本
推荐阅读:
1、Java 1.8——java.util.Collection包学习记录
2、如何彻底修改SQL server的数据库名
3、java图片上传服务器及客户端显示图片