net.lenni0451.classtransform.annotations

Annotation Type CLocalVariable

@Retention(value=CLASS)
 @Target(value=PARAMETER)
public @interface CLocalVariable

The priority for identifying the local variable is:
1. name(): The name of the local variable found in the local variable table.
2. ordinal(): The ordinal of the local variable in the local variable table.
3. index(): The variable index of the local variable.

If none of name(), ordinal() or index() are set, the local variable will be identified by the name of the method parameter.

See Also:

GitHub Wiki

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
int	index The var index of the local variable to get.
int	loadOpcode The opcode used to load the variable.
boolean	modifiable Copy the value of the local variable back to the caller method.
java.lang.String	name The name of the local variable found in the local variable table.
int	ordinal The ordinal of the local variable to get from the local variable table.

Element Detail

name

public abstract java.lang.String name

The name of the local variable found in the local variable table.
The local variable table is optional in the class file but is required for the name resolution.
Use the index if no local variable table is present.

Returns:

The name of the local variable

Default:

""

ordinal

public abstract int ordinal

The ordinal of the local variable to get from the local variable table.
The ordinal is counted for every type of local variable (e.g. I, L, Ljava/lang/String;, ...).
Use the index if no local variable table is present.

Returns:

The ordinal

Default:

-1

index

public abstract int index

The var index of the local variable to get.

Returns:

The var index

Default:

-1

loadOpcode

public abstract int loadOpcode

The opcode used to load the variable.
Only required if the opcode could not be resolved automatically (e.g. reusing local variable indices).
Allowed Values:
- ILOAD
- LLOAD
- FLOAD
- DLOAD
- ALOAD

Returns:

The opcode

Default:

-1

modifiable

public abstract boolean modifiable

Copy the value of the local variable back to the caller method.
When marking a local variable as modifiable the type of the method parameter is deciding the type of the stored local variable.
You can use Object to get any non-primitive variable, but it will be stored back as an Object and not as the original type.
This may cause a ClassCastException when not careful.

Returns:

If the local variable should be copied back

Default:

false