uniquelyOccurring()

Implementation Notes

The implementation does not emit anything until the full input stream has been exhausted, so it is not suitable for infinite streams. Encounter order of uniquely occurring elements is preserved.

Note that uniquelyOccurring() is semantically different from the JDK’s Stream::distinct()or Gatherer4j’s distinctBy()because only elements that are already distinct are emitted, rather than emitting all elements only once.

Signature

uniquelyOccurring()

Examples

Limit stream to elements that occur a single time

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

// ["B", "C"]