The following table lists the instruction's hexadecimal and Microsoft Intermediate Language (MSIL) assembly format, along with a brief reference summary:
20 < int32 > |
ldc.i4 num |
Pushes the value num onto the stack. |
The stack transitional behavior, in sequential order, is:
[The 'ordered' type of list has not been implemented in the ECMA stylesheet.]Note that there are special short (and hence more efficient) encodings for the integers -128 through 127, and especially short encodings for -1 through 8. All short encodings push 4 byte integers on the stack. Longer encodings are used for 8 byte integers and 4 and 8 byte floating-point numbers, as well as 4-byte values that do not fit in the short forms. There are three ways to push an 8 byte integer constant onto the stack
1. Use the OpCodes.Ldc_I8 instruction for constants that must be expressed in more than 32 bits.
2. Use the OpCodes.Ldc_I4 instruction followed by a OpCodes.Conv_I8 for constants that require 9 to 32 bits.
3. Use a short form instruction followed by a OpCodes.Conv_I8 for constants that can be expressed in 8 or fewer bits.
The following ILGenerator.Emit(OpCode) method overload can use the ldc.i4 opcode:
ILGenerator.Emit(OpCode, int)