System.Reflection.Emit.OpCodes.Ldc_I4 Field

Pushes a supplied value of type int32 onto the evaluation stack as an int32.

Syntax

public static readonly OpCode Ldc_I4

Remarks

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)

Requirements

Namespace: System.Reflection.Emit
Assembly: mscorlib (in mscorlib.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0, 4.0.0.0