Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)

# Gatherer.Downstream

` public static interface Gatherer.Downstream `   
` `

|---|
| java.util.stream.Gatherer.Downstream\<T\> |

<br />

*** ** * ** ***

A Downstream object is the next stage in a pipeline of operations, to which elements can be sent.

## Summary

| ### Public methods ||
|---|---|
| ` default boolean` | ` https://developer.android.com/reference/java/util/stream/Gatherer.Downstream#isRejecting()() ` Checks whether the next stage is known to not want any more elements sent to it. |
| ` abstract boolean` | ` https://developer.android.com/reference/java/util/stream/Gatherer.Downstream#push(T)(T element) ` Pushes, if possible, the provided element downstream -- to the next stage in the pipeline. |

## Public methods

### isRejecting

Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)

```
public boolean isRejecting ()
```

Checks whether the next stage is known to not want any more elements sent to it.

<br />

##### API Note:

- This is best-effort only, once this returns `true` it should never return `false` again for the same instance.

##### Implementation Requirements:

- The implementation in this interface returns `false`.

| Returns ||
|---|---|
| `boolean` | `true` if this Downstream is known not to want any more elements sent to it, `false` if otherwise <br /> |

### push

Added in [version 36.1](https://developer.android.com/topic/libraries/support-library/revisions)

```
public abstract boolean push (T element)
```

Pushes, if possible, the provided element downstream -- to the next stage in the pipeline.

<br />

##### Implementation Requirements:

- If this method returns `false` then no further elements will be accepted and subsequent invocations of this method will return `false`.

| Parameters ||
|---|---|
| `element` | `T`: the element to push downstream <br /> |

| Returns ||
|---|---|
| `boolean` | `true` if more elements can be sent, and `false` if not. <br /> |