Export (0) Print
Expand All
Expand Minimize

OpCodes.Ldc_I4 Field

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

Namespace:  System.Reflection.Emit
Assembly:  mscorlib (in mscorlib.dll)

public static readonly OpCode Ldc_I4

The following table lists the instruction's hexadecimal and Microsoft Intermediate Language (MSIL) assembly format, along with a brief reference summary:

Format

Assembly Format

Description

20 < int32 >

ldc.i4 num

Pushes the value num onto the stack.

The stack transitional behavior, in sequential order, is:

  1. The value num is pushed onto the stack.

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 Ldc_I8 instruction for constants that must be expressed in more than 32 bits.

2. Use the Ldc_I4 instruction followed by a Conv_I8 for constants that require 9 to 32 bits.

3. Use a short form instruction followed by a Conv_I8 for constants that can be expressed in 8 or fewer bits.

The following Emit method overload can use the ldc.i4 opcode:

  • ILGenerator.Emit(OpCode, int)

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft