Класс ValueLayout

public ByteOrder order()

Возвращает порядок байтов значения.

public ValueLayout withOrder(ByteOrder order)

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

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<ValueLayout>> describeConstable()

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

public ValueLayout withName(String name)

Создаёт новую компоновку, которая имеет желаемое имя компоновки.

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

    withAttribute(LAYOUT_NAME, name);
 

public ValueLayout withBitAlignment(long alignmentBits)

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

public ValueLayout 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 выравнивание по типу int, A=16 выравнивание по типу short и т.д.
• A=512 — это самое строгое требование выравнивания, необходимое ABI x86/SV (для данных AVX-512).

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

public boolean hasSize()

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

public long bitSize()

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

public boolean isPadding()

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