intersperse()

Implementation Notes

The given element is only placed between elements of the input stream, never before the first or after the last, so a stream of n elements gains n - 1 copies of it. Empty and single-element streams are emitted unchanged. The element to intersperse may be null.

To alternate with elements from another source rather than repeating a single element, see interleaveWith().

Signature

intersperse(INPUT intersperseElement)

• intersperseElement - The element to put between each pair of adjacent elements, which may be null

Examples

Put a separator between each element

Stream
    .of("A", "B", "C")
    .gather(Gatherers4j.intersperse("-"))
    .toList();

// [ "A", "-", "B", "-", "C" ]

A single-element stream is unchanged

Stream
    .of("A")
    .gather(Gatherers4j.intersperse("-"))
    .toList();

// [ "A" ]

Intersperse null

Stream
    .of("A", "B", "C")
    .gather(Gatherers4j.intersperse(null))
    .toList();

// [ "A", null, "B", null, "C" ]