NdArraySequence

общедоступный интерфейс NdArraySequence

Известные косвенные подклассы FastElementSequence <T, U расширяет NdArray <T>>, SingleElementSequence <T, U расширяет NdArray <T>>, SlicingElementSequence <T, U расширяет NdArray <T>> FastElementSequence <T, U расширяет NdArray <T>> Последовательность, повторно использующая один и тот же экземпляр NdArray при повторении его элементов. SingleElementSequence <T, U расширяет NdArray <T>> Последовательность одного элемента SlicingElementSequence <T, U расширяет NdArray <T>> Последовательность, создающая новый экземпляр (срез) NdArray для каждого элемента итерации.

Последовательность элементов N-мерного массива.

NdArraySequence используется для перемещения по NdArray в заданном измерении и посещения каждого из его элементов. Например, для матрицы nxm по осям [x, y] элементы повторяются в следующем порядке:

x ₀ y ₀ , x ₀ y ₁ , ..., x ₀ y _m-1 , x ₁ y ₀ , x ₁ y ₁ , ..., x _n-1 y _m-1

Публичные методы

абстрактный NdArraySequence <T>	asSlices () Возвращает каждый элемент как новый срез.
абстрактная пустота	forEachIndexed (потребитель BiConsumer<long[], T>) Посетите каждый элемент этой итерации и их соответствующие координаты.

Унаследованные методы

Из интерфейса java.lang.Iterable

абстрактная пустота	forEach (Consumer<? super T> arg0)
абстрактный итератор<T>	итератор ()
абстрактный Сплитератор<T>	сплитатор ()

Публичные методы

общедоступный абстрактный NdArraySequence <T> asSlices ()

Возвращает каждый элемент как новый срез.

В отличие от обычных коллекций Java, элементы NdArraySequence являются временными, т. е. для каждой итерации выделяются новые экземпляры NdArray . Чтобы повысить производительность, один и тот же экземпляр можно повторно использовать для просмотра всех элементов этой последовательности с помощью DataBufferWindow .

Однако в некоторых случаях может быть предпочтительнее отключить такую ​​оптимизацию, чтобы гарантировать, что каждый возвращаемый элемент представляет собой новый фрагмент исходного массива. Например, если один или несколько посещенных элементов должны находиться за пределами итерации последовательности, asSlices() гарантирует, что все элементы, возвращаемые последовательностью, являются уникальными экземплярами.

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
 

Возврат

• последовательность, которая возвращает каждый повторяемый элемент как новый срез

См. также

• DataBufferWindow

общедоступная абстрактная пустота forEachIndexed (потребитель BiConsumer<long[], T>)

Посетите каждый элемент этой итерации и их соответствующие координаты.

Важно: метод-потребитель не должен хранить ссылку на координаты, поскольку они могут быть изменяемыми и повторно использоваться во время итерации для повышения производительности.

Параметры

потребитель	метод для вызова для каждого элемента