prev next contents
caload

retrieve character from array

Jasmin Syntax


    caload

Stack

Before

After
index
value
arrayref
...
...
...
Description

Retrieves a character from an array of characters and pushes it on the operand stack. arrayref is a reference to an array of chars. index is an int. The arrayref and index are removed from the stack, and the 16-bit unsigned Unicode character at the given index in the array is retrieved, zero extended to a 32-bit int, and pushed onto the stack.

Example


; This is like the Java code:
;     char x = arr[0];
; where x is local variable 2 and arr is a
; char array in local variable 1
aload_1       ; load local variable 1 onto the stack
iconst_0      ; push the integer 0 onto the stack
caload        ; retrieve the entry
istore_2      ; store the entry in local variable 2
Exceptions

NullPointerException - arrayref is null

ArrayIndexOutOfBoundsException - index is < 0 or >= arrayref.length

Bytecode

Type

Description
u1
caload opcode = 0x34 (52)
See Also

iaload, laload, faload, daload, aaload, baload, saload, iastore, lastore, fastore, dastore, aastore, bastore, castore, sastore

Notes

Array indices start at 0 (the first entry in the array is at index 0).


prev next contents
Java Virtual Machine, by Jon Meyer and Troy Downing, O'Reilly Associates