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[0] + ", " + t[1]));
}
}
```

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
```

Link to blogpost

## Discussion (0)