Smart Card Solution
User Manual
- R502 Manual
JavaCard API Samples
- Algorithm
Java Card Specification
Knowledge Sharing
Smart Card Solution
User Manual
JavaCard API Samples
Java Card Specification
Knowledge Sharing
Set field in object
Format
putfield_
index
Forms
putfield_a = 135 (0x87) putfield_b = 136 (0x88) putfield_s = 137 (0x89) putfield_i = 138 (0x8a)
Stack
…, objectref, value → …
OR
…, objectref, value.word1, value.word2 → …
Description
The unsigned index is used as an index into the constant pool of the current package ( Section 3.5, Frames). The constant pool item at the index must be of type CONSTANT_InstanceFieldref ( Section 6.7.2, CONSTANT_InstanceFieldref, CONSTANT_VirtualMethodref, and CONSTANT_SuperMethodref), a reference to a class and a field token.
The class of objectref must not be an array. If the field is protected, and it is a member of a superclass of the current class, and the field is not declared in the same package as the current class, then the class of objectref must be either the current class or a subclass of the current class. If the field is final, it must be declared in the current class.
The item must resolve to a field with a type that matches t, as follows:
value must be of a type that is assignment compatible with the field descriptor (t) type.
The width of a field in a class instance is determined by the field type specified in the instruction. The item is resolved, determining the field offset<SUP>[10]</SUP>. The objectref, which must be of type reference, and the value are popped from the operand stack. If the field is of type byte or type boolean, the value is truncated to a byte. The field at the offset from the start of the object referenced by objectref is set to the value.
Runtime Exception
If objectref is null, the putfield_ instruction throws a NullPointerException.
Notes
In some circumstances, the putfield_ instruction may throw a SecurityException if the current context Section 3.4, Contexts) is not the owning context ( Section 3.4, Contexts) of the object referenced by objectref. The exact circumstances when the exception will be thrown are specified in Chapter 6 of the Runtime Environment Specification, Java Card Platform, Version 2.2.2.
If a virtual machine does not support the int data type, the putfield_i instruction will not be available.