Класс SequenceLayout

public MemoryLayout elementLayout()

Возвращает компоновку элемента, связанную с этой компоновкой последовательности.

public OptionalLong elementCount()

Возвращает количество элементов этой компоновки последовательности (если есть).

public SequenceLayout withElementCount(long elementCount)

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

public SequenceLayout reshape(long... elementCounts)

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

Например, для компоновки последовательности типа:

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

вызов seq.reshape(2, 6) даст следующую компоновку последовательности:

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

Если одно из предоставленных количеств элементов является специальным значением -1, то количество элементов в этой позиции будет выведено из оставшихся количеств элементов и количества элементов уплощенной проекции этого макета. Например, макет, эквивалентный вышеуказанному reshapeSeq, также может быть вычислен следующим образом:

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

public SequenceLayout flatten()

Возвращает новую, уплощенную компоновку последовательности, чья компоновка элемента является первой не-последовательной компоновкой элемента, найденной путём рекурсивного обхода компоновок элементов этой компоновки последовательности. Эта трансформация сохраняет размер макета; вложенные компоновки последовательности в этой компоновке последовательности будут удалены, а их количества элементов будут включены в количество элементов возвращаемой компоновки последовательности. Например, для компоновки последовательности типа:

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

вызов seq.flatten() даст следующую компоновку последовательности:

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

public String toString()

Возвращает строковое представление объекта.

public boolean equals(Object other)

Указывает, является ли какой-либо другой объект "равным" этому.

Метод equals реализует отношение эквивалентности на ссылках на объекты, отличных от null:

• Он рефлексивен: для любой ссылки на объект, отличной от null, x, x.equals(x) должен возвращать true.
• Он симметричен: для любых значений ссылок на объекты, отличные от null, x и y, x.equals(y) должен возвращать true тогда и только тогда, когда y.equals(x) возвращает true.
• Он транзитивен: для любых значений ссылок на объекты, отличные от null, x, y, и z, если x.equals(y) возвращает true и y.equals(z) возвращает true, то x.equals(z) должен возвращать true.
• Он постоянен: для любых значений ссылок на объекты, отличные от null, x и y, многократные вызовы x.equals(y) последовательно возвращают true или последовательно возвращают false, при условии, что никакие данные, используемые в сравнениях equals объектов, не модифицируются.
• Для любого значения ссылки на объект, отличного от null, x, x.equals(null) должен возвращать false.

Отношение эквивалентности разбивает элементы, на которые она действует, на классы эквивалентности; все члены класса эквивалентности равны друг другу. Члены класса эквивалентности взаимозаменяемы, по крайней мере, для некоторых целей.

public int hashCode()

Возвращает хеш-код для объекта. Этот метод поддерживается для использования в хеш-таблицах, таких как предоставляемые HashMap.

Общий контракт hashCode:

• Всякий раз, когда он вызывается для одного и того же объекта более чем один раз во время выполнения Java-приложения, метод hashCode должен последовательно возвращать то же целое число, при условии, что никакие данные, используемые в сравнениях equals объекта, не модифицированы. Это целое число не обязательно должно оставаться постоянным от одного выполнения приложения к другому выполнению того же приложения.
• Если два объекта равны согласно методу equals, то вызов метода hashCode для каждого из двух объектов должен генерировать один и тот же целочисленный результат.
• Не требуется, чтобы если два объекта не равны согласно методу equals, то вызов метода hashCode для каждого из двух объектов генерировал разные целочисленные результаты. Однако программист должен понимать, что выработка различных целочисленных результатов для неравных объектов может улучшить производительность хеш-таблиц.

public Optional<DynamicConstantDesc<SequenceLayout>> describeConstable()

Возвращает Optional, содержащий номинальный дескриптор для этого макета, если его можно создать, или пустой Optional, если его нельзя создать.

public SequenceLayout withName(String name)

Создаёт новый макет с желаемым именем макета.

Это эквивалентно следующему коду:

    withAttribute(LAYOUT_NAME, name);
 

public SequenceLayout withBitAlignment(long alignmentBits)

Создаёт новую компоновку с заданным ограничением выравнивания.

public SequenceLayout withAttribute(String name, Constable value)

Возвращает новую компоновку памяти, которая содержит те же атрибуты, что и эта компоновка, плюс новый указанный атрибут. Если эта компоновка уже содержит атрибут с тем же именем, значение существующего атрибута перезаписывается в возвращаемой компоновке.

public final Optional<String> name()

Возвращает имя (если есть) ассоциированное с этой компоновкой.

Эквивалентно следующему коду:

    attribute(LAYOUT_NAME).map(String.class::cast);
 

public Optional<Constable> attribute(String name)

Возвращает атрибут с данным именем (если он существует).

public Stream<String> attributes()

Возвращает поток имён атрибутов, связанных с этой компоновкой.

public final long bitAlignment()

Возвращает ограничение выравнивания компоновки, выраженное в битах. Выравнивание компоновки определяет степень двойки A, которая является битовым выравниванием компоновки. Если A <= 8, то A/8 — это количество байт, которые должны быть выровнены для любого указателя, который правильно указывает на эту компоновку. Таким образом:

• A=8 означает отсутствие выравнивания (в обычном смысле), что обычно используется в пакетах.
• A=64 означает выравнивание по словам (в LP64), A=32 по целым числам, A=16 по коротким целым числам и т. д.
• A=512 — это самое строгое выравнивание, необходимое x86/SV ABI (для данных AVX-512).

Если для этой компоновки не было задано явного ограничения выравнивания (см. MemoryLayout.withBitAlignment(long)), то этот метод возвращает ограничение естественного выравнивания (в битах) этой компоновки.

public boolean hasSize()

Имеет ли эта компоновка заданный размер? У компоновки нет заданного размера, если она (или содержит) компоновку последовательности, размер которой не определён (см. elementCount()). Компоновки значений (см. ValueLayout) и компоновки заполнения (см. MemoryLayout.paddingLayout(long)) всегда имеют указанный размер, поэтому этот метод всегда возвращает true в этих случаях.

public long bitSize()

Вычисляет размер компоновки в битах.

public boolean isPadding()

Является ли это компоновкой заполнения (например, компоновкой, созданной из MemoryLayout.paddingLayout(long)) ?