compact1, compact2, compact3

java.lang

Interface Iterable<T>

参数类型

T - 迭代器返回的元素的类型

All Known Subinterfaces:

BeanContext ， BeanContextServices ， BlockingDeque <E>， BlockingQueue <E>， Collection <E>， Deque <E>， DirectoryStream <T>， List <E>， NavigableSet <E>， Path ， Queue <E>， SecureDirectoryStream <T> ， Set <E>， SortedSet <E>， TransferQueue <E>

所有已知实现类：

AbstractCollection ， AbstractList ， AbstractQueue ， AbstractSequentialList ， AbstractSet ， ArrayBlockingQueue ， ArrayDeque ， ArrayList ， AttributeList ， BatchUpdateException ， BeanContextServicesSupport ， BeanContextSupport ， ConcurrentHashMap.KeySetView ， ConcurrentLinkedDeque ， ConcurrentLinkedQueue ， ConcurrentSkipListSet ， CopyOnWriteArrayList ， CopyOnWriteArraySet ， DataTruncation ， DelayQueue ， EnumSet ， HashSet ， JobStateReasons ， LinkedBlockingDeque ， LinkedBlockingQueue ， LinkedHashSet ， LinkedList ， LinkedTransferQueue ， PriorityBlockingQueue ， PriorityQueue ， RoleList ， RoleUnresolvedList ， RowSetWarning ， SerialException ， ServiceLoader ， SQLClientInfoException ， SQLDataException ， SQLException ， SQLFeatureNotSupportedException ， SQLIntegrityConstraintViolationException ， SQLInvalidAuthorizationSpecException ， SQLNonTransientConnectionException ， SQLNonTransientException ， SQLRecoverableException ， SQLSyntaxErrorException ， SQLTimeoutException ， SQLTransactionRollbackException ， SQLTransientConnectionException ， SQLTransientException ， SQLWarning ， Stack ， SyncFactoryException ， SynchronousQueue ， SyncProviderException ， TreeSet ， Vector

public interface Iterable<T>

实现此接口允许对象成为“for-each loop”语句的目标。 见For-each Loop

从以下版本开始：

1.5

See The Java™ Language Specification:

14.14.2加强声明

方法摘要

Modifier and Type	Method and Description
default void	forEach(Consumer<? super T> action) 对 Iterable的每个元素执行给定的操作，直到所有元素都被处理或动作引发异常。
Iterator<T>	iterator() 返回类型为 T元素的迭代器。
default Spliterator<T>	spliterator() 在Iterable描述的元素上创建一个Iterable 。

方法详细信息

iterator

Iterator<T> iterator()

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

结果

一个迭代器

forEach

default void forEach(Consumer<? super T> action)

对Iterable的每个元素执行给定的操作，直到所有元素都被处理或动作引发异常。 除非实现类另有规定，否则按照迭代的顺序执行操作（如果指定了迭代顺序）。 动作抛出的异常被转发给呼叫者。

实现要求：

默认实现的行为如下：

   for (T t : this) action.accept(t);  

参数

action - 要为每个元素执行的操作

异常

NullPointerException - 如果指定的动作为空

从以下版本开始：

1.8

spliterator

default Spliterator<T> spliterator()

在Iterable描述的元素上创建一个Iterable 。

实现要求：

默认实现从iterable的Iterator创建一个early-binding拼接器。 Spliter继承了iterable的迭代器的fail-fast属性。

Implementation Note:

通常应该覆盖默认的实现。 由默认实现返回的分割器具有差的分割能力，未定义，并且不报告任何分割器特征。 实施课程几乎总能提供更好的实现。

结果

一个 Spliterator在由此描述的元件 Iterable 。

从以下版本开始：

1.8