Add Iterables.intersperse()

[John Kozlov]

Add a function intersperse, that takes an element and an Iterable and "intersperses" that element between the elements of the Iterable. For example:

Iterables.intersperse(Arrays.asList(1, 2, 3), 0)

will return 1, 0, 2, 0, 3.

[John Kozlov]

A good use case: you want to print multiple strings with a line between each two strings:

List<String> lines = Arrays.asList("Line1", "Line2", "Line3");
for (String s : intersperse(lines, "-------")) {
    System.out.println(s);
}

This will print:

Line1
-------
Line2
-------
Line3

[Jed Wesley-Smith]

fixed in commit 50bb08827988ba81dc2fda4d767089e2fad28a9d should be released 2.3