org.dmfs.jems.iterable.composite

Class Joined<T>

java.lang.Object

org.dmfs.jems.iterable.composite.Joined<T>

Type Parameters:

T - The type of the iterated elements.

All Implemented Interfaces:

java.lang.Iterable<T>

public final class Joined<T>
extends java.lang.Object
implements java.lang.Iterable<T>

An Iterable which joins other Iterables by iterating the values of them one after another.

Note: other frameworks call this operation, "flatten". While this is technically appropriate, it often doesn't really express the intent very well. For instance, if you want to iterate the elements of two lists one after another, this code is probably easier to grasp:

 Iterable<SomeType> result = new Joined<>(list1, list2);
 

than this one

 Iterable<SomeType> result = new Flattened<>(list1, list2);
 

Constructor Summary

Constructors

Constructor and Description
Joined(java.lang.Iterable<java.lang.Iterable<T>> iterables)
Joined(java.lang.Iterable<T>... iterables)

Method Summary

Modifier and Type	Method and Description
java.util.Iterator<T>	iterator()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Joined

@SafeVarargs
public Joined(java.lang.Iterable<T>... iterables)

Joined

public Joined(java.lang.Iterable<java.lang.Iterable<T>> iterables)

Method Detail

iterator

public java.util.Iterator<T> iterator()

Specified by:

iterator in interface java.lang.Iterable<T>