# Java Streams flatMap Demo

The below example shows how we can use `flatMap()` to get the unique combination of two integers for all integers up to n. For n=3, this would be
(1, 1) (1, 2) (1, 3) (2, 2) (2, 3) (3, 3).

To obtain a stream of 3 integers (1, 2, 3) use `IntStream.rangeClosed(1, 3)`

Map works with a stream of types, so convert this to a stream of 3 Integers by using `.boxed()`.

Now starting from 1, we want to make a combination of that number with each integer following it.

So for each `i` we can obtain another stream by `IntStream.rangeClosed(i, n)`.

If we use `map()`, as below, we'll end up with a stream of streams.

``````map(a -> IntStream.rangeClosed(a, 3)
.mapToObj( b -> new double[]{a, b}))
``````

This would be a stream of 3 streams. The first stream will have [1, 1] [1, 2] [1, 3], the second will have [2, 2] and [2, 3]. The third will have [3, 3].

If instead, we use `flatMap()` as below, we'll end up with one stream.

``````flatMap(a -> IntStream.rangeClosed(a, 3)
.mapToObj( b -> new double[]{a, b}))
``````

This would be the stream
[1, 1] [1, 2] [1, 3] [2, 2] [2, 3] [3, 3].

The complete program.

``````
import java.util.stream.IntStream;
public class FlatMapDemo {
public static void main(String[] args) {

System.out.println("\n\nStep 1 one primitive integer stream \n------");
IntStream.rangeClosed(1, 3)  // one stream
.forEach(t -> System.out.print(t + " - primitive " +  ", "));

System.out.println("\n\nStep 2 boxed to Integer stream \n------");
IntStream.rangeClosed(1, 3).boxed()  // one stream
.forEach(t -> System.out.print(t + " - " + t.getClass().getTypeName() + ", "));

System.out.println("\n\nStep 3 Print stream Regular map \n------");
IntStream.rangeClosed(1, 3)
.boxed()
.map(a -> IntStream.rangeClosed(a, 3)                  // regular map, stream of streams
.mapToObj( b -> new int[]{a, b}))
.forEach(t ->  System.out.println(t  +  " - contains " + t.count()));

System.out.println("\n\nStep 4 Print stream Flat map \n------");
IntStream.rangeClosed(1, 3)
.boxed()
.flatMap(a -> IntStream.rangeClosed(a, 3)               // flat map, one stream
.mapToObj( b -> new int[]{a, b}))
.forEach(t ->  System.out.println(t + " - " + t.getClass().getTypeName() + " Contents: " + t + ", " + t));
}
}

``````

The output will be

``````Step 1 one primitive integer stream
------
1 - primitive , 2 - primitive , 3 - primitive ,

Step 2 boxed to Integer stream
------
1 - java.lang.Integer, 2 - java.lang.Integer, 3 - java.lang.Integer,

Step 3 Print stream Regular map
------
java.util.stream.IntPipeline\$1@6aceb1a5 - contains 3
java.util.stream.IntPipeline\$1@4c75cab9 - contains 2
java.util.stream.IntPipeline\$1@1ef7fe8e - contains 1

Step 4 Print stream Flat map
------
[I@6979e8cb - int[] Contents: 1, 1
[I@763d9750 - int[] Contents: 1, 2
[I@5c0369c4 - int[] Contents: 1, 3
[I@2be94b0f - int[] Contents: 2, 2
[I@d70c109 - int[] Contents: 2, 3
[I@17ed40e0 - int[] Contents: 3, 3

``````