System.Reflection.Emit.OpCodes.Ldarg_S Field

Loads the argument (referenced by a specified short form index) onto the evaluation stack.

Syntax

public static readonly OpCode Ldarg_S

Remarks

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

0E < unsigned int8 >

ldarg.s index

Load argument at index onto stack, short form.

The stack transitional behavior, in sequential order, is:

[The 'ordered' type of list has not been implemented in the ECMA stylesheet.]

The ldarg.s instruction is an efficient encoding for loading arguments indexed from 4 through 255.

The ldarg.s instruction pushes the argument indexed at index, where arguments are indexed from 0 onwards, onto the evaluation stack. The ldarg.s instruction can be used to load a value type or a primitive value onto the stack by copying it from an incoming argument. The type of the argument value is the same as the type of the argument, as specified by the current method's signature.

For procedures that take a variable-length argument list, the ldarg.s instruction can be used only for the initial fixed arguments, not those in the variable part of the signature (see the OpCodes.Arglist instruction for more details).

Arguments that hold an integer value smaller than 4 bytes long are expanded to type int32 when they are loaded onto the stack. Floating-point values are expanded to their native size (type F).

The following ILGenerator.Emit(OpCode) method overload can use the ldarg.s opcode:

  • ILGenerator.Emit(OpCode, byte)

Requirements

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