Streams generally produce elements lazily and avoid production of excess elements when there are short circuiting operations. However, for less common cases laziness is not possible There is a tradeoff between implementation complexity and laziness.

Problematic cases arise for the use of an "escape hatch" iterator or spliterator terminal operation .

It would be beneficial to add some guidance to the stream package documentation.