# FastElementSequence

public final class **FastElementSequence** A sequence recycling the same `NdArray` instance when iterating its elements

### Public Constructors

|---|---|
|   | [FastElementSequence](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/impl/sequence/FastElementSequence#FastElementSequence(org.tensorflow.ndarray.impl.AbstractNdArray<T, U>, int, U, org.tensorflow.ndarray.buffer.DataBufferWindow<?>))([AbstractNdArray](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/impl/AbstractNdArray)\<T, U\> ndArray, int dimensionIdx, U element, [DataBufferWindow](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/buffer/DataBufferWindow)\<?\> elementWindow) |

### Public Methods

|---|---|
| [NdArraySequence](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArraySequence)\<U\> | [asSlices](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/impl/sequence/FastElementSequence#asSlices())() Returns each element as a new slice. |
| void | [forEachIndexed](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/impl/sequence/FastElementSequence#forEachIndexed(java.util.function.BiConsumer<long[], U>))(BiConsumer\<long\[\], U\> consumer) |
| Iterator\<U\> | [iterator](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/impl/sequence/FastElementSequence#iterator())() |

### Inherited Methods

From class java.lang.Object

|---|---|
| boolean | equals(Object arg0) |
| final Class\<?\> | getClass() |
| int | hashCode() |
| final void | notify() |
| final void | notifyAll() |
| String | toString() |
| final void | wait(long arg0, int arg1) |
| final void | wait(long arg0) |
| final void | wait() |

From interface [org.tensorflow.ndarray.NdArraySequence](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArraySequence)

|---|---|
| abstract [NdArraySequence](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArraySequence)\<U extends [NdArray](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArray)\<T\>\> | [asSlices](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArraySequence#asSlices())() Returns each element as a new slice. |
| abstract void | [forEachIndexed](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArraySequence#forEachIndexed(java.util.function.BiConsumer<long[], T>))(BiConsumer\<long\[\], U extends [NdArray](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArray)\<T\>\> consumer) Visit each elements of this iteration and their respective coordinates. |

From interface java.lang.Iterable

|---|---|
| abstract void | forEach(Consumer\<? super T\> arg0) |
| abstract Iterator\<U extends [NdArray](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArray)\<T\>\> | iterator() |
| abstract Spliterator\<U extends [NdArray](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArray)\<T\>\> | spliterator() |

## Public Constructors

#### public
**FastElementSequence**
([AbstractNdArray](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/impl/AbstractNdArray)\<T, U\> ndArray, int dimensionIdx, U element, [DataBufferWindow](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/buffer/DataBufferWindow)\<?\> elementWindow)

<br />

## Public Methods

#### public [NdArraySequence](https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/NdArraySequence)\<U\>
**asSlices**
()

Returns each element as a new slice.

Unlike conventional Java collections, elements of a `NdArraySequence` are transient, i.e. new `NdArray`
instances are allocated for each iteration. To improve performance, the same instance can be recycled to view
all elements of this sequence, using a `https://www.tensorflow.org/jvm/api_docs/java/org/tensorflow/ndarray/buffer/DataBufferWindow`.

In some cases though, it might be preferable to disable such optimizations to ensure that each element returned is a
new slice of the original array. For example, if one or more elements visited must live beyond the scope of the sequence
iteration, `asSlices()` makes sure that all elements returned by the sequence are unique instances.

    final List<IntNdArray> vectors = new ArrayList<>();
         IntNdArray matrix = NdArrays.ofInts(Shape.of(6, 6));
         ndArray.elements(0).forEach(e -> vectors::add);  // Not safe, as `e` might always be the same recycled instance
         ndArray.elements(0).asSlices().forEach(e -> vectors::add);  // Safe, each `e` is a distinct NdArray instance
     
<br />

<br />

<br />

##### Returns

- a sequence that returns each elements iterated as a new slice

#### public void
**forEachIndexed**
(BiConsumer\<long\[\], U\> consumer)

<br />

#### public Iterator\<U\>
**iterator**
()

<br />