Интерфейс ConstantInstruction

Все суперинтерфейсы:: ClassFileElement, CodeElement, Instruction

Все известные подинтерфейсы:: ConstantInstruction.ArgumentConstantInstruction, ConstantInstruction.IntrinsicConstantInstruction, ConstantInstruction.LoadConstantInstruction

public sealed interface ConstantInstruction extends Instruction permits ConstantInstruction.IntrinsicConstantInstruction, ConstantInstruction.ArgumentConstantInstruction, ConstantInstruction.LoadConstantInstruction

Представляет инструкцию загрузки константы в массиве code атрибута


Code

, включая «встроенные», «аргументные» и «загружающие» инструкции констант. Соответствующие коды операций имеют вид Opcode.Kind.CONSTANT. Передаётся как CodeElement при обходе элементов CodeModel.

Загружаемое значение константы символически представлено как ConstantDesc:

ConstantInstruction(ConstantDesc constantValue)

Граф запечатанной иерархии классов:

Sealed class hierarchy graph for ConstantInstruction

Начиная с:

См. также:

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

Модификатор и тип	Интерфейс	Описание
`static interface`	`ConstantInstruction.ArgumentConstantInstruction`	Представляет инструкцию «аргументная константа», в которой значение константы непосредственно закодировано в инструкции.
`static interface`	`ConstantInstruction.IntrinsicConstantInstruction`	Представляет инструкцию «встроенная константа», в которой значение константы закодировано в её коде операции.
`static interface`	`ConstantInstruction.LoadConstantInstruction`	Представляет инструкцию «загрузка константы», в которой значение константы закодировано в пуле констант.

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

Модификатор и тип	Метод	Описание
`ConstantDesc`	`constantValue()`	Возвращает значение константы.
`static ConstantInstruction.ArgumentConstantInstruction`	`ofArgument(Opcode op, int value)`	Возвращает инструкцию аргументной константы.
`static ConstantInstruction.IntrinsicConstantInstruction`	`ofIntrinsic(Opcode op)`	Возвращает инструкцию встроенной константы.
`static ConstantInstruction.LoadConstantInstruction`	`ofLoad(Opcode op, LoadableConstantEntry constant)`	Возвращает инструкцию загрузки константы.
`TypeKind`	`typeKind()`	Возвращает вычислительный тип константы.

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

opcode, sizeInBytes

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

constantValue

ConstantDesc constantValue()

Возвращает значение константы.

Возвращает:: значение константы

typeKind

TypeKind typeKind()

Возвращает вычислительный тип константы. Он определяется на основе constantValue.

Возвращает:: вычислительный тип константы

ofIntrinsic

static ConstantInstruction.IntrinsicConstantInstruction ofIntrinsic(Opcode op)

Возвращает инструкцию встроенной константы.

Параметры:: op — код операции для конкретного типа инструкции встроенной константы; он должен иметь вид Opcode.Kind.CONSTANT
Возвращает:: инструкцию встроенной константы
Вызывает исключение:: IllegalArgumentException — если код операции не представляет константу с неявным значением

ofArgument

static ConstantInstruction.ArgumentConstantInstruction ofArgument(Opcode op, int value)

Возвращает инструкцию аргументной константы.

value должно находиться в диапазоне от byte до [-128, 127] для Opcode.BIPUSH и в диапазоне от short до [-32768, 32767] для Opcode.SIPUSH.

Параметры:: op — код операции для конкретного типа инструкции аргументной константы; им должен быть Opcode.BIPUSH или Opcode.SIPUSH; value — значение константы
Возвращает:: инструкцию аргументной константы
Вызывает исключение:: IllegalArgumentException — если код операции не является Opcode.BIPUSH или Opcode.SIPUSH либо значение константы выходит за допустимый для этого кода операции диапазон

ofLoad

static ConstantInstruction.LoadConstantInstruction ofLoad(Opcode op, LoadableConstantEntry constant)

Возвращает инструкцию загрузки константы.

Параметры:: op — код операции для конкретного типа инструкции загрузки константы; он должен иметь вид Opcode.Kind.CONSTANT; constant — значение константы
Возвращает:: инструкцию загрузки константы
Вызывает исключение:: IllegalArgumentException — если код операции не является Opcode.LDC, Opcode.LDC_W или Opcode.LDC2_W

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/lang/classfile/instruction/ConstantInstruction.html