prev next contents
ifnonnull

jump if non-null

Jasmin Syntax 


    ifnonnull <label>
<label> is a label name. To define the location of the label, use the <label> name followed by a colon: 

<label>:
<label> then becomes associated the address of the following instruction. Labels can only be assigned one location in a method. On the other hand, a single <label> can be the target of multiple branch instructions.

Stack

Before

After
objectref
...
...

Description

ifnonnull pops the top object reference off the operand stack. If the object reference is not the special null reference, execution branches to the address (pc + branchoffset), where pc is the address of the ifnonnull opcode in the bytecode and branchoffset is a 16-bit signed integer parameter following the ifnonnull opcode in the bytecode. If the object reference on the stack is null, execution continues at the next instruction.

If you are using Jasmin, branchoffset is computed for you from the address of <label>.

Example 


    aload_1         ; push the object reference in local variable 1 onto the stack
    ifnonnull Label ; if local variable isn't null, jump to Label
    return          ; return if local variable 1 is null
Label:
    ; execution continues here if local variable 1 is something other than null ...
Bytecode

Type

Description
u1
ifnonnull opcode = 0xC7 (199)
s2
branchoffset
See Also

ifnull, ifeq, ifle, iflt, ifne, ifgt, ifge

Notes

Addresses are measured in bytes from the start of the bytecode (i.e. address 0 is the first byte in the bytecode of the currently executing method).

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