Difference between revisions of "Instruction set: CIL"
From ScienceZero
(→Local variables) |
(→Array elements) |
||
Line 273: | Line 273: | ||
|} | |} | ||
+ | |||
+ | ==Indirect access= | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Name !! Description | ||
+ | |- | ||
+ | |Ldind.I || Loads a value of type natural int as a natural int onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.I1 || Loads a value of type int8 as an int32 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.I2 || Loads a value of type int16 as an int32 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.I4 || Loads a value of type int32 as an int32 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.I8 || Loads a value of type int64 as an int64 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.R4 || Loads a value of type float32 as a type F (float) onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.R8 || Loads a value of type float64 as a type F (float) onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.Ref || Loads an object reference as a type O (object reference) onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.U1 || Loads a value of type unsigned int8 as an int32 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.U2 || Loads a value of type unsigned int16 as an int32 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Ldind.U4 || Loads a value of type unsigned int32 as an int32 onto the evaluation stack indirectly. | ||
+ | |- | ||
+ | |Stind.I || Stores a value of type natural int at a supplied address. | ||
+ | |- | ||
+ | |Stind.I1 || Stores a value of type int8 at a supplied address. | ||
+ | |- | ||
+ | |Stind.I2 || Stores a value of type int16 at a supplied address. | ||
+ | |- | ||
+ | |Stind.I4 || Stores a value of type int32 at a supplied address. | ||
+ | |- | ||
+ | |Stind.I8 || Stores a value of type int64 at a supplied address. | ||
+ | |- | ||
+ | |Stind.R4 || Stores a value of type float32 at a supplied address. | ||
+ | |- | ||
+ | |Stind.R8 || Stores a value of type float64 at a supplied address. | ||
+ | |- | ||
+ | |Stind.Ref || Stores a object reference value at a supplied address. | ||
+ | |} | ||
[[Category:Computing]] | [[Category:Computing]] |
Revision as of 03:56, 9 October 2007
Contents
Arithmetic
Name | Description |
---|---|
Add | Adds two values and pushes the result onto the evaluation stack. |
Add.Ovf | Adds two integers, performs an overflow check, and pushes the result onto the evaluation stack. |
Add.Ovf.Un | Adds two unsigned integer values, performs an overflow check, and pushes the result onto the evaluation stack. |
Div | Divides two values and pushes the result as a floating-point (type F) or quotient (type int32) onto the evaluation stack. |
Div.Un | Divides two unsigned integer values and pushes the result (int32) onto the evaluation stack. |
Mul | Multiplies two values and pushes the result on the evaluation stack. |
Mul.Ovf | Multiplies two integer values, performs an overflow check, and pushes the result onto the evaluation stack. |
Mul.Ovf.Un | Multiplies two unsigned integer values, performs an overflow check, and pushes the result onto the evaluation stack. |
Neg | Negates a value and pushes the result onto the evaluation stack. |
Rem | Divides two values and pushes the remainder onto the evaluation stack. |
Rem.Un | Divides two unsigned values and pushes the remainder onto the evaluation stack. |
Sub | Subtracts one value from another and pushes the result onto the evaluation stack. |
Sub.Ovf | Subtracts one integer value from another, performs an overflow check, and pushes the result onto the evaluation stack. |
Sub.Ovf.Un | Subtracts one unsigned integer value from another, performs an overflow check, and pushes the result onto the evaluation stack. |
Logical and shift
Name | Description |
---|---|
And | Computes the bitwise AND of two values and pushes the result onto the evaluation stack. |
Or | Compute the bitwise complement of the two integer values on top of the stack and pushes the result onto the evaluation stack. |
Not | Computes the bitwise complement of the integer value on top of the stack and pushes the result onto the evaluation stack as the same type. |
Xor | Computes the bitwise XOR of the top two values on the evaluation stack, pushing the result onto the evaluation stack. |
Shl | Shifts an integer value to the left (in zeroes) by a specified number of bits, pushing the result onto the evaluation stack. |
Shr | Shifts an integer value (in sign) to the right by a specified number of bits, pushing the result onto the evaluation stack. |
Shr.Un | Shifts an unsigned integer value (in zeroes) to the right by a specified number of bits, pushing the result onto the evaluation stack. |
Compares
Name | Description |
---|---|
Ceq | Compares two values. If they are equal, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack. |
Cgt | Compares two values. If the first value is greater than the second, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack. |
Cgt.Un | Compares two unsigned or unordered values. If the first value is greater than the second, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack. |
Clt | Compares two values. If the first value is less than the second, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack. |
Clt.Un | Compares the unsigned or unordered values value1 and value2. If value1 is less than value2, then the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack. |
Load constants
Name | Description |
---|---|
Ldc.I4 | Pushes a supplied value of type int32 onto the evaluation stack as an int32. |
Ldc.I4.0 | Pushes the integer value of 0 onto the evaluation stack as an int32. |
Ldc.I4.1 | Pushes the integer value of 1 onto the evaluation stack as an int32. |
Ldc.I4.2 | Pushes the integer value of 2 onto the evaluation stack as an int32. |
Ldc.I4.3 | Pushes the integer value of 3 onto the evaluation stack as an int32. |
Ldc.I4.4 | Pushes the integer value of 4 onto the evaluation stack as an int32. |
Ldc.I4.5 | Pushes the integer value of 5 onto the evaluation stack as an int32. |
Ldc.I4.6 | Pushes the integer value of 6 onto the evaluation stack as an int32. |
Ldc.I4.7 | Pushes the integer value of 7 onto the evaluation stack as an int32. |
Ldc.I4.8 | Pushes the integer value of 8 onto the evaluation stack as an int32. |
Ldc.I4.M1 | Pushes the integer value of -1 onto the evaluation stack as an int32. |
Ldc.I4.S | Pushes the supplied int8 value onto the evaluation stack as an int32, short form. |
Ldc.I8 | Pushes a supplied value of type int64 onto the evaluation stack as an int64. |
Ldc.R4 | Pushes a supplied value of type float32 onto the evaluation stack as type F (float). |
Ldc.R8 | Pushes a supplied value of type float64 onto the evaluation stack as type F (float). |
Branching
Add ".S" for short form.
Name | Description |
---|---|
Br | Unconditionally transfers control to a target instruction. |
Beq | Transfers control to a target instruction if two values are equal. |
Bge | Transfers control to a target instruction if the first value is greater than or equal to the second value. |
Bge.Un | Transfers control to a target instruction if the first value is greater than the second value, when comparing unsigned integer values or unordered float values. |
Bgt | Transfers control to a target instruction if the first value is greater than the second value. |
Bgt.Un | Transfers control to a target instruction if the first value is greater than the second value, when comparing unsigned integer values or unordered float values. |
Ble | Transfers control to a target instruction if the first value is less than or equal to the second value. |
Ble.Un | 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. |
Blt | Transfers control to a target instruction if the first value is less than the second value. |
Blt.Un | Transfers control to a target instruction if the first value is less than the second value, when comparing unsigned integer values or unordered float values. |
Bne.Un | Transfers control to a target instruction when two unsigned integer values or unordered float values are not equal. |
Brfalse | Transfers control to a target instruction if value is false, a null reference (Nothing in Visual Basic), or zero. |
Brtrue | Transfers control to a target instruction if value is true, not null, or non-zero. |
Calling methods
Name | Description |
---|---|
Call | Calls the method indicated by the passed method descriptor. |
Calli | Calls the method indicated on the evaluation stack (as a pointer to an entry point) with arguments described by a calling convention. |
Callvirt | Calls a late-bound method on an object, pushing the return value onto the evaluation stack. |
Ret | Returns from the current method, pushing a return value (if present) from the callee's evaluation stack onto the caller's evaluation stack. |
Jmp | Exits current method and jumps to specified method. |
Local variables
Name | Description |
---|---|
Ldloc | Loads the local variable at a specific index onto the evaluation stack. |
Ldloc.0 | Loads the local variable at index 0 onto the evaluation stack. |
Ldloc.1 | Loads the local variable at index 1 onto the evaluation stack. |
Ldloc.2 | Loads the local variable at index 2 onto the evaluation stack. |
Ldloc.3 | Loads the local variable at index 3 onto the evaluation stack. |
Ldloc.S | Loads the local variable at a specific index onto the evaluation stack, short form. |
Ldloca | Loads the address of the local variable at a specific index onto the evaluation stack. |
Ldloca.S | Loads the address of the local variable at a specific index onto the evaluation stack, short form. |
Stloc | Pops the current value from the top of the evaluation stack and stores it in a the local variable list at a specified index. |
Stloc.0 | Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 0. |
Stloc.1 | Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 1. |
Stloc.2 | Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 2. |
Stloc.3 | Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 3. |
Stloc.S | Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index (short form). |
Arguments
Name | Description |
---|---|
Arglist | Returns an unmanaged pointer to the argument list of the current method. |
Ldarg | Loads an argument (referenced by a specified index value) onto the stack. |
Ldarg.0 | Loads the argument at index 0 onto the evaluation stack. |
Ldarg.1 | Loads the argument at index 1 onto the evaluation stack. |
Ldarg.2 | Loads the argument at index 2 onto the evaluation stack. |
Ldarg.3 | Loads the argument at index 3 onto the evaluation stack. |
Ldarg.S | Loads the argument (referenced by a specified short form index) onto the evaluation stack. |
Ldarga | Load an argument address onto the evaluation stack. |
Ldarga.S | Load an argument address, in short form, onto the evaluation stack. |
Starg | Stores the value on top of the evaluation stack in the argument slot at a specified index. |
Starg.S | Stores the value on top of the evaluation stack in the argument slot at a specified index, short form. |
Array elements
Name | Description |
---|---|
Ldelem | Loads the element at a specified array index onto the top of the evaluation stack as the type specified in the instruction. |
Ldelem.I | Loads the element with type natural int at a specified array index onto the top of the evaluation stack as a natural int. |
Ldelem.I1 | Loads the element with type int8 at a specified array index onto the top of the evaluation stack as an int32. |
Ldelem.I2 | Loads the element with type int16 at a specified array index onto the top of the evaluation stack as an int32. |
Ldelem.I4 | Loads the element with type int32 at a specified array index onto the top of the evaluation stack as an int32. |
Ldelem.I8 | Loads the element with type int64 at a specified array index onto the top of the evaluation stack as an int64. |
Ldelem.R4 | Loads the element with type float32 at a specified array index onto the top of the evaluation stack as type F (float). |
Ldelem.R8 | Loads the element with type float64 at a specified array index onto the top of the evaluation stack as type F (float). |
Ldelem.Ref | Loads the element containing an object reference at a specified array index onto the top of the evaluation stack as type O (object reference). |
Ldelem.U1 | Loads the element with type unsigned int8 at a specified array index onto the top of the evaluation stack as an int32. |
Ldelem.U2 | Loads the element with type unsigned int16 at a specified array index onto the top of the evaluation stack as an int32. |
Ldelem.U4 | Loads the element with type unsigned int32 at a specified array index onto the top of the evaluation stack as an int32. |
Ldelema | Loads the address of the array element at a specified array index onto the top of the evaluation stack as type & (managed pointer). |
Stelem | Replaces the array element at a given index with the value on the evaluation stack, whose type is specified in the instruction. |
Stelem.I | Replaces the array element at a given index with the natural int value on the evaluation stack. |
Stelem.I1 | Replaces the array element at a given index with the int8 value on the evaluation stack. |
Stelem.I2 | Replaces the array element at a given index with the int16 value on the evaluation stack. |
Stelem.I4 | Replaces the array element at a given index with the int32 value on the evaluation stack. |
Stelem.I8 | Replaces the array element at a given index with the int64 value on the evaluation stack. |
Stelem.R4 | Replaces the array element at a given index with the float32 value on the evaluation stack. |
Stelem.R8 | Replaces the array element at a given index with the float64 value on the evaluation stack. |
Stelem.Ref | Replaces the array element at a given index with the object ref value (type O) on the evaluation stack. |
=Indirect access
Name | Description |
---|---|
Ldind.I | Loads a value of type natural int as a natural int onto the evaluation stack indirectly. |
Ldind.I1 | Loads a value of type int8 as an int32 onto the evaluation stack indirectly. |
Ldind.I2 | Loads a value of type int16 as an int32 onto the evaluation stack indirectly. |
Ldind.I4 | Loads a value of type int32 as an int32 onto the evaluation stack indirectly. |
Ldind.I8 | Loads a value of type int64 as an int64 onto the evaluation stack indirectly. |
Ldind.R4 | Loads a value of type float32 as a type F (float) onto the evaluation stack indirectly. |
Ldind.R8 | Loads a value of type float64 as a type F (float) onto the evaluation stack indirectly. |
Ldind.Ref | Loads an object reference as a type O (object reference) onto the evaluation stack indirectly. |
Ldind.U1 | Loads a value of type unsigned int8 as an int32 onto the evaluation stack indirectly. |
Ldind.U2 | Loads a value of type unsigned int16 as an int32 onto the evaluation stack indirectly. |
Ldind.U4 | Loads a value of type unsigned int32 as an int32 onto the evaluation stack indirectly. |
Stind.I | Stores a value of type natural int at a supplied address. |
Stind.I1 | Stores a value of type int8 at a supplied address. |
Stind.I2 | Stores a value of type int16 at a supplied address. |
Stind.I4 | Stores a value of type int32 at a supplied address. |
Stind.I8 | Stores a value of type int64 at a supplied address. |
Stind.R4 | Stores a value of type float32 at a supplied address. |
Stind.R8 | Stores a value of type float64 at a supplied address. |
Stind.Ref | Stores a object reference value at a supplied address. |