Интерфейс 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

Since:: 1.5

Методы

Модификатор и тип	Метод и описание
`default void`	`forEach(Consumer<? super T> action)` Выполняет заданное действие для каждого элемента `Iterable` до тех пор, пока все элементы не будут обработаны или действие не выбросит исключение.
`Iterator<T>`	`iterator()` Возвращает итератор по элементам типа `T`.
`default Spliterator<T>`	`spliterator()` Создаёт `Spliterator` по элементам, описываемым этим `Iterable`.

Методы

iterator

Iterator<T> iterator()

Возвращает итератор по элементам типа T.

Возвращает:: итератор.

forEach

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

Выполняет заданное действие для каждого элемента Iterable до тех пор, пока все элементы не будут обработаны или действие не выбросит исключение. Если не указано иное классом-реализацией, действия выполняются в порядке итерации (если порядок итерации задан). Исключения, выброшенные действием, передаются вызывающему методу.

Требования к реализации:

По умолчанию реализация ведет себя так, как если бы:

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

Параметры:

action - действие, которое должно выполняться для каждого элемента

Исключения:

NullPointerException - если указанное действие равно null

Since:

1.8

spliterator

default Spliterator<T> spliterator()

Создаёт Spliterator по элементам, описываемым этим Iterable.

Требования к реализации:: Реализация по умолчанию создаёт early-binding-итератор из Iterator итерабельного объекта. Итератор наследует свойства fail-fast итератора итерабельного объекта.
Примечание реализации:: Реализация по умолчанию обычно должна быть переопределена. Итератор, возвращаемый реализацией по умолчанию, имеет плохие возможности разделения, не определён размер и не сообщает о каких-либо характеристиках итератора. Реализующие классы практически всегда могут предоставить лучшую реализацию.
Возвращает:: Spliterator по элементам, описываемым этим Iterable.
Since:: 1.8

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.