# IntStream.Builder

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)

# Builder

```
interface Builder : IntConsumer
```

|--------------------------------------------------------------------------------------------------------------------------|
| [java.util.stream.IntStream.Builder](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#) |

A mutable builder for an`IntStream`.

A stream builder has a lifecycle, which starts in a building phase, during which elements can be added, and then transitions to a built phase, after which elements may not be added. The built phase begins when the[build()](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#build())method is called, which creates an ordered stream whose elements are the elements that were added to the stream builder, in the order they were added.

## Summary

|                                                                                                                                                                        Public methods                                                                                                                                                                        ||
|--------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| abstract[Unit](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-unit/index.html)                         | [accept](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#accept(kotlin.Int))`(`t:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Adds an element to the stream being built. |
| open[IntStream.Builder](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#)! | [add](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#add(kotlin.Int))`(`t:` `[Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)`)` Adds an element to the stream being built.       |
| abstract[IntStream](https://developer.android.com/reference/kotlin/java/util/stream/IntStream)!              | [build](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#build())`()` Builds the stream, transitioning this builder to the built state.                                                                       |

| Inherited functions ||
|---|---|
| From class[IntConsumer](https://developer.android.com/reference/kotlin/java/util/function/IntConsumer.html#) |-----------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [IntConsumer](https://developer.android.com/reference/kotlin/java/util/function/IntConsumer.html#)! | [andThen](https://developer.android.com/reference/kotlin/java/util/function/IntConsumer.html#andThen(java.util.function.IntConsumer))`(`after:` `[IntConsumer](https://developer.android.com/reference/kotlin/java/util/function/IntConsumer.html#)!`)` <br /> Returns a composed`IntConsumer`that performs, in sequence, this operation followed by the`after`operation. If performing either operation throws an exception, it is relayed to the caller of the composed operation. If performing this operation throws an exception, the`after`operation will not be performed. <br /> | ||

## Public methods

### accept

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun accept(t: Int): Unit
```

Adds an element to the stream being built.

|         Parameters          ||
|---------|--------------------|
| `value` | the input argument |

|                                          Exceptions                                           ||
|-----------------------------------|------------------------------------------------------------|
| `java.lang.IllegalStateException` | if the builder has already transitioned to the built state |

### add

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
open fun add(t: Int): IntStream.Builder!
```

Adds an element to the stream being built.

|                                             Parameters                                             ||
|-----|-----------------------------------------------------------------------------------------------|
| `t` | [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html):the element to add |

|                                                         Return                                                          ||
|----------------------------------------------------------------------------------------------------------|---------------|
| [IntStream.Builder](https://developer.android.com/reference/kotlin/java/util/stream/IntStream.Builder#)! | `this`builder |

|                                          Exceptions                                           ||
|-----------------------------------|------------------------------------------------------------|
| `java.lang.IllegalStateException` | if the builder has already transitioned to the built state |

### build

Added in[API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels)  

```
abstract fun build(): IntStream!
```

Builds the stream, transitioning this builder to the built state. An`IllegalStateException`is thrown if there are further attempts to operate on the builder after it has entered the built state.

|                                                  Return                                                   ||
|-----------------------------------------------------------------------------------------|------------------|
| [IntStream](https://developer.android.com/reference/kotlin/java/util/stream/IntStream)! | the built stream |

|                                          Exceptions                                           ||
|-----------------------------------|------------------------------------------------------------|
| `java.lang.IllegalStateException` | if the builder has already transitioned to the built state |