byte
or boolean
arraybastore |
Stack ..., arrayref, index, value ...
Description
The arrayref must be of type reference
and must refer to an array whose components are of type byte
or of type boolean
. The index and the value must both be of type int
. The arrayref, index, and value are popped from the operand stack. The int
value is truncated to a byte
and stored as the component of the array indexed by index.
Runtime Exceptions
If arrayref is null
, bastore throws a NullPointerException
.
Otherwise, if index is not within the bounds of the array referenced by arrayref, the bastore instruction throws an ArrayIndexOutOfBoundsException
.
Notes
The bastore instruction is used to store values into both byte
and boolean
arrays. In Sun's implementation of the Java Virtual Machine, boolean
arrays (arrays of type T_BOOLEAN
; see §3.1 and the description of the newarray instruction) are implemented as arrays of 8-bit values. Other implementations may implement packed boolean
arrays; the bastore instruction of such implementations must be used to store into those arrays.