【Iterable JDK1.8】java.lang.Iterable 接口

文章目录

• • 常见方法
  • • iterator
  • JDK1.8 新增方法
  • • forEach
    • spliterator

源码来源 java.lang.Iterable

实现这个接口允许对象成为“for-each循环”语句的目标。具体细节请查看The For-Each Loop，或其译文

常见方法

iterator

返回T类型元素的一个迭代器。

JDK1.8 新增方法

forEach

为可迭代的每个元素执行给定的操作，直到处理完所有元素或操作引发异常为止。除非实现类另有指定，否则操作将按迭代顺序执行(如果指定了迭代顺序)。该操作引发的异常将传递给调用者。

默认实现的行为如下:

default void forEach(Consumer<? super T> action) {
    Objects.requireNonNull(action);
    for (T t : this) {
        action.accept(t);
    }
}
           

spliterator

在这个

Iterable

描述的元素上创建一个

Spliterator

。

默认实现从iterable的迭代器创建一个早期绑定spliterator。spliterator继承了iterable的迭代器的快速失败（fail-fast）属性。

通常应该重写默认实现。默认实现返回的spliterator具有较差的分割功能，没有调整大小，并且不报告任何spliterator特性。实现类几乎总是可以提供更好的实现。

default Spliterator<T> spliterator() {
    return Spliterators.spliteratorUnknownSize(iterator(), 0);
}