Интерфейс SequenceLayout

MemoryLayout elementLayout()

Возвращает:

макет элемента этого последовательного макета

long elementCount()

Возвращает:

число элементов этого последовательного макета

SequenceLayout withElementCount(long elementCount)

Параметры:

elementCount — новое число элементов

Возвращает:

последовательный макет с теми же характеристиками, что и у этого макета, но с заданным числом элементов

Вызывает исключение:

IllegalArgumentException — если elementCount отрицательно

IllegalArgumentException — если происходит переполнение elementLayout.bitSize() * elementCount

SequenceLayout reshape(long... elementCounts)

var seq = MemoryLayout.sequenceLayout(4, MemoryLayout.sequenceLayout(3, ValueLayout.JAVA_INT));

var reshapeSeq = MemoryLayout.sequenceLayout(2, MemoryLayout.sequenceLayout(6, ValueLayout.JAVA_INT));

var reshapeSeqImplicit1 = seq.reshape(-1, 6);
var reshapeSeqImplicit2 = seq.reshape(2, -1);

Параметры:

elementCounts — массив чисел элементов, не более одного из которых может быть -1

Возвращает:

последовательный макет, в котором макеты элементов из уплощённого представления этого последовательного макета (см. flatten()) переупорядочены в один или несколько вложенных последовательных макетов

Вызывает исключение:

IllegalArgumentException — если двум или более числам элементов присвоено значение -1, либо если одно или несколько чисел элементов равны <= 0 (но не -1), либо если после необходимого вычисления произведение чисел элементов не равно числу элементов в уплощённом представлении этого последовательного макета

SequenceLayout flatten()

MemoryLayout flatElementLayout(SequenceLayout sequenceLayout) {
   return switch (sequenceLayout.elementLayout()) {
       case SequenceLayout nestedSequenceLayout -> flatElementLayout(nestedSequenceLayout);
       case MemoryLayout layout -> layout;
   };
}

var seq = MemoryLayout.sequenceLayout(4, MemoryLayout.sequenceLayout(3, ValueLayout.JAVA_INT));

var flattenedSeq = MemoryLayout.sequenceLayout(12, ValueLayout.JAVA_INT);

Возвращает:

последовательный макет того же размера, что и этот макет (но, возможно, с другим числом элементов), макет элемента которого не является последовательным макетом

SequenceLayout withName(String name)

Переопределено из:

withName в интерфейсе MemoryLayout

Параметры:

name — имя макета

Возвращает:

макет памяти с теми же характеристиками, что и у этого макета, но с заданным именем

См. также:

• MemoryLayout.name()

SequenceLayout withByteAlignment(long byteAlignment)

Переопределено из:

withByteAlignment в интерфейсе MemoryLayout

Параметры:

byteAlignment — ограничение выравнивания макета, выраженное в байтах

Возвращает:

макет памяти с теми же характеристиками, что и у этого макета, но с заданным ограничением выравнивания (в байтах)

Вызывает исключение:

IllegalArgumentException — если byteAlignment не является степенью двойки

IllegalArgumentException — если byteAlignment < elementLayout().byteAlignment()