ListIterator是Java中专为List设计的双向迭代器,支持正向/反向遍历、按索引定位、以及add/set/remove安全修改操作,其所有行为围绕光标位置展开,需遵循调用约束(如set/remove前必须调用next/previous)。

ListIterator 是 Java 中专为双向遍历和安全修改 List 而设计的迭代器,它比普通 Iterator 多出向前遍历、获取索引、添加/替换元素等能力。关键在于它维护一个“光标位置”,所有操作都围绕当前位置展开。
双向遍历:用 hasNext() 和 hasPrevious() 控制方向
ListIterator 既支持从头到尾(正向),也支持从尾到头(反向)。它的光标初始位于第一个元素之前,调用 next() 向前移动并返回下一个元素;调用 previous() 向后移动并返回上一个元素。
- 正向遍历时,先用 hasNext() 判断是否还有元素,再调用 next()
- 反向遍历时,先用 hasPrevious() 判断是否还有前驱元素,再调用 previous()
- 注意:不能在未调用 next() 或 previous() 的情况下直接调用 set() 或 remove(),否则抛 IllegalStateException
安全修改列表:add()、set()、remove() 的使用时机
ListIterator 允许在遍历过程中增删改,但每种操作有明确约束:
- add(E e):在光标当前位置前插入元素,插入后光标位于新元素之后,不影响后续 next(),但会使下次 previous() 返回新元素
- set(E e):替换上一次由 next() 或 previous() 返回的元素,必须已调用过取值方法,且不能紧接着 add() 后调用(会抛异常)
- remove():删除上一次由 next() 或 previous() 返回的元素,同样要求已调用过取值方法,且不能与 add() 或 set() 连续调用
获取当前位置信息:nextIndex() 与 previousIndex()
这两个方法不移动光标,只返回逻辑索引:
立即学习“Java免费学习笔记(深入)”;
- nextIndex() 返回调用 next() 将访问的元素索引(范围是 0 到 size())
- previousIndex() 返回调用 previous() 将访问的元素索引(范围是 -1 到 size()-1)
- 例如:光标在第一个元素前时,nextIndex() 是 0,previousIndex() 是 -1;光标在最后一个元素后时,nextIndex() 是 size(),previousIndex() 是 size()-1
创建与典型用法示例
只能通过 List 的 listIterator() 方法获取(如 ArrayList、LinkedList 支持),不能直接 new。常用模式如下:
- 正向遍历并修改:list.listIterator() → 循环 hasNext()/next() → 在合适位置调用 set() 或 remove()
- 反向遍历并插入:list.listIterator(list.size())(光标置于末尾)→ 循环 hasPrevious()/previous() → 在需要位置调用 add()
- 混合操作:比如查找某元素后插入新项,可先正向 next() 找到目标,再 add() 插入其后


















