Интерфейс PaddingLayout

Все суперинтерфейсы:: MemoryLayout

public sealed interface PaddingLayout extends MemoryLayout

Компоновка с заполнением. Компоновка с заполнением задаёт размер дополнительного пространства, к которому обычно не обращаются приложения и которое, как правило, используется для выравнивания компоновок элементов по границам слов.

Требования к реализации:: Реализующие классы являются неизменяемыми, потокобезопасными и основанными на значениях.
Начиная с версии:: 22

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в интерфейсе MemoryLayout

MemoryLayout.PathElement

Модификатор и тип	Интерфейс	Описание
`static interface`	`MemoryLayout.PathElement`	Элемент в пути компоновки.

Краткое описание методов

Модификатор и тип	Метод	Описание
`PaddingLayout`	`withByteAlignment(long byteAlignment)`	Возвращает компоновку памяти с теми же характеристиками, что и эта компоновка, но с заданным ограничением выравнивания (в байтах).
`PaddingLayout`	`withName(String name)`	Возвращает компоновку памяти с теми же характеристиками, что и эта компоновка, но с заданным именем.
`PaddingLayout`	`withoutName()`	Возвращает компоновку памяти с теми же характеристиками, что и эта компоновка, но без имени.

Методы, объявленные в интерфейсе MemoryLayout

arrayElementVarHandle, byteAlignment, byteOffset, byteOffsetHandle, byteSize, equals, hashCode, name, scale, scaleHandle, select, sliceHandle, toString, varHandle

Модификатор и тип	Метод	Описание
`VarHandle`	`arrayElementVarHandle(MemoryLayout.PathElement... elements)`	Создаёт var handle, обращающийся к соседним элементам сегмента памяти по смещениям, выбранным заданным путем компоновки, причём компоновка доступных элементов совпадает с этой компоновкой, а начальная компоновка в пути — это эта компоновка.
`long`	`byteAlignment()`	Возвращает ограничение выравнивания, связанное с этой компоновкой, в байтах.
`long`	`byteOffset(MemoryLayout.PathElement... elements)`	Вычисляет смещение в байтах компоновки, выбранной заданным путем компоновки, начальной компоновкой в котором является эта компоновка.
`MethodHandle`	`byteOffsetHandle(MemoryLayout.PathElement... elements)`	Создаёт method handle, вычисляющий смещение в байтах компоновки, выбранной заданным путем компоновки, начальной компоновкой в котором является эта компоновка.
`long`	`byteSize()`	Возвращает размер компоновки в байтах.
`boolean`	`equals(Object other)`	Сравнивает указанный объект с этой компоновкой на равенство.
`int`	`hashCode()`	Возвращает хеш-код этой компоновки.
`Optional<String>`	`name()`	Возвращает имя (если оно есть), связанное с этой компоновкой.
`long`	`scale(long offset, long index)`	Возвращает `offset + (byteSize() * index)`.
`MethodHandle`	`scaleHandle()`	Возвращает method handle, который можно использовать для вызова `MemoryLayout.scale(long, long)` для этой компоновки.
`MemoryLayout`	`select(MemoryLayout.PathElement... elements)`	Возвращает компоновку, выбранную из заданного пути, начальной компоновкой в котором является эта компоновка.
`MethodHandle`	`sliceHandle(MemoryLayout.PathElement... elements)`	Создаёт method handle, который принимает сегмент памяти и возвращает срез, соответствующий компоновке, выбранной заданным путем компоновки, начальной компоновкой в котором является эта компоновка.
`String`	`toString()`	Возвращает строковое представление этой компоновки.
`VarHandle`	`varHandle(MemoryLayout.PathElement... elements)`	Создаёт var handle, обращающийся к сегменту памяти по смещению, выбранному заданным путем компоновки, начальной компоновкой в котором является эта компоновка.

Подробное описание методов

withName

PaddingLayout withName(String name)

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

Переопределяет:

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

Параметры:

name - имя компоновки

Возвращает:

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

См. также:

withoutName

PaddingLayout withoutName()

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

Переопределяет:

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

Возвращает:

компоновку памяти с теми же характеристиками, что и эта компоновка, но без имени

См. также:

withByteAlignment

PaddingLayout withByteAlignment(long byteAlignment)

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

Переопределяет:: withByteAlignment в интерфейсе MemoryLayout
Параметры:: byteAlignment - ограничение выравнивания компоновки, выраженное в байтах
Возвращает:: компоновку памяти с теми же характеристиками, что и эта компоновка, но с заданным ограничением выравнивания (в байтах)
Выбрасывает:: IllegalArgumentException - если byteAlignment не является степенью двойки

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.