==== 7.5.13 bastore ====

Store into byte or boolean array 

Format 

bastore 

Forms 

bastore = 56 (0x38) 

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 value must both be of type short. The arrayref, index and value are popped from the operand stack. The short 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 

In some circumstances, the bastore instruction may throw a SecurityException if the current context ([[3.4_Contexts| Section 3.4, Contexts]]) is not the owning context ([[3.4_Contexts| Section 3.4, Contexts]]) of the array referenced by arrayref. 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//**.