Какова функция метода peek в API Stream?

Метод peek в API Stream используется для промежуточного просмотра элементов потока без изменения самого потока. Он позволяет выполнить действие над каждым элементом (например, вывести на экран или залогировать), не влияя на дальнейшую обработку.

peek полезен для отладки или логирования, так как не изменяет поток и не запускает его обработку (ленивое выполнение).

Пример использования:

Stream.of("a", "b", "c")
      .peek(s -> System.out.println("Processing: " + s))
      .map(String::toUpperCase)
      .forEach(System.out::println);

В этом примере peek выводит каждый элемент перед преобразованием в верхний регистр.