compact1、compact2、compact3

java.lang

インタフェースIterable<T>

型パラメータ:

T - イテレータから返される要素の型

既知のすべてのサブインタフェース:

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ループ」文の対象にすることができます。「for-eachループ」を参照してください

導入されたバージョン:

1.5

『Java(tm)言語仕様』を参照してください。

14.14.2 拡張されたfor文

メソッドのサマリー

修飾子と型	メソッドと説明
default void	forEach(Consumer<? super T> action) Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。
Iterator<T>	iterator() 型Tの要素のイテレータを返します。
default Spliterator<T>	spliterator() このIterableによって記述される要素に対するSpliteratorを作成します。

メソッドの詳細

iterator

Iterator<T> iterator()

型Tの要素のイテレータを返します。

戻り値:

イテレータ。

forEach

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

Iterableの各要素に対して指定されたアクションを、すべての要素が処理されるか、アクションが例外をスローするまで実行します。実装クラスで指定されない場合は、反復の順序でアクションが実行されます(反復順序が指定されている場合)。アクションによってスローされた例外は、呼出し側に中継されます。

実装要件:

デフォルト実装の動作は次のようになります。

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

パラメータ:

action - 各要素に対して実行されるアクション

例外:

NullPointerException - 指定されたアクションがnullである場合

導入されたバージョン:

1.8

spliterator

default Spliterator<T> spliterator()

このIterableによって記述される要素に対するSpliteratorを作成します。

実装要件:

デフォルト実装では、反復可能オブジェクトのIteratorから早期バインディングのスプリッテレータを作成します。そのスプリッテレータは、その反復可能オブジェクトのイテレータのフェイルファスト特性を継承します。

実装上の注意:

デフォルト実装は通常、オーバーライドする必要があります。デフォルト実装から返されるスプリッテレータは分割機能が貧弱であり、それぞれに合ったサイズがないため、スプリッテレータの特性がまったく生かされません。クラスを実装することで、より良い実装を提供できることがほとんどです。

戻り値:

このIterableによって記述される要素に対するSpliterator

導入されたバージョン:

1.8