Enum Class ClassFile.DeadLabelsOption
- All Implemented Interfaces:
Serializable
,ClassFile.Option
,Comparable<ClassFile.DeadLabelsOption>
,Constable
- Enclosing interface:
ClassFile
public static enum ClassFile.DeadLabelsOption
extends Enum<ClassFile.DeadLabelsOption>
implements ClassFile.Option
The option describing whether to filter unbound labels and drop their
enclosing structures if possible. The default is
FAIL_ON_DEAD_LABELS
to fail fast with an IllegalArgumentException
when a PseudoInstruction
refers to an unbound label during
bytecode generation.
The affected PseudoInstruction
s include ExceptionCatch
,
LocalVariable
, LocalVariableType
, and CharacterRange
. Setting this option to DROP_DEAD_LABELS
filters these pseudo-instructions from a CodeBuilder
instead.
Note that instructions, such as BranchInstruction
, with unbound
labels always fail-fast with an IllegalArgumentException
.
- Since:
- 24
- See Also:
-
Nested Class Summary
Nested classes/interfaces declared in class java.lang.Enum
Enum.EnumDesc<E extends Enum<E>>
-
Enum Constant Summary
Enum ConstantsEnum ConstantDescriptionFilterPseudoInstruction
s with unbound labels.Fail fast on unbound labels. -
Method Summary
Modifier and TypeMethodDescriptionstatic ClassFile.DeadLabelsOption
Returns the enum constant of this class with the specified name.static ClassFile.DeadLabelsOption[]
values()
Returns an array containing the constants of this enum class, in the order they are declared.
-
Enum Constant Details
-
FAIL_ON_DEAD_LABELS
Fail fast on unbound labels. This also ensures the accuracy of the generatedclass
files. -
DROP_DEAD_LABELS
FilterPseudoInstruction
s with unbound labels. Note that instructions with unbound labels still cause anIllegalArgumentException
.
-
-
Method Details
-
values
Returns an array containing the constants of this enum class, in the order they are declared.- Returns:
- an array containing the constants of this enum class, in the order they are declared
-
valueOf
Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)- Parameters:
name
- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException
- if this enum class has no constant with the specified nameNullPointerException
- if the argument is null
-