145.

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