| Format | Assembly Format | Description |
|---|---|---|
| 3A <int32> | brtrue target |
Branch to target if value is non-zero (true). |
| 2D <int8> | brtrue.s target |
Branch to target if value is non-zero (true), short form. |
| 3A <int32> | brinst target |
Branch to target if value is a non-null object reference (alias for brtrue). |
| 2D <int8> | brinst.s target |
Branch to target if value is a non-null object reference, short form (alias for brtrue.s). |
…, value → …
The brtrue instruction transfers control to target if value (of type native int) is nonzero (true). If value is zero (false) execution continues at the next instruction.
If the value is an object reference (type O) then brinst (an alias for brtrue) transfers control if it represents an instance of an object (i.e., isn't the null object reference, see ldnull).
target is represented as a signed offset (4 bytes for brtrue, 1 byte for brtrue.s) from the beginning of the instruction following the current instruction.
If the target instruction has one or more prefix codes, control can only be transferred to the first of these prefixes.
Control transfers into and out of try, catch, filter, and finally blocks cannot be performed by this instruction. (Such transfers are severely restricted and shall use the leave instruction instead; see Partition I for details).
None.
Correct CIL shall observe all of the control transfer rules specified above and shall guarantee there is a minimum of one item on the stack.
Verifiable code requires the type-consistency of the stack, locals and arguments for every possible path to the destination instruction. See §III.1.8 for more details.