[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Transfers control to a target instruction if the first value is less than or equal to the second value, when comparing unsigned integer values or unordered float values.
Assembly: mscorlib (in mscorlib.dll)
The following table lists the instruction's hexadecimal and Microsoft intermediate language (MSIL) assembly format, along with a brief reference summary:
Branch to the target instruction at the specified offset if the first value is less than or equal to the second value (unsigned values).
The stack transitional behavior, in sequential order, is:
value1 is pushed onto the stack.
value2 is pushed onto the stack.
value2 and value1 are popped from the stack; if value1 is less than or equal to value2, the branch operation is performed.
The ble.un instruction transfers control to the specified target instruction if value1 is less than or equal to value2, when compared using unsigned integer or unordered float values. The effect is identical to performing a cgt.un instruction (cgt for floats) followed by a brfalse branch to the specific target instruction. The target instruction is represented as a 4-byte signed offset from the beginning of the instruction following the current instruction.
Control can only be transferred to the first of these prefixes if the target instruction has one or more prefix codes. Control transfers into and out of try, catch, filter, and finally blocks cannot be performed by this instruction.
The following Emit method overload can use the ble.un opcode: