IntPtr.Subtraction(IntPtr, Int32) Operator

Definition

Subtrahiert einen Offset von einer signierten ganzzahligen Zahl.

public:
 static IntPtr operator -(IntPtr pointer, int offset);
public static IntPtr operator -(IntPtr pointer, int offset);
static member ( - ) : nativeint * int -> nativeint
Public Shared Operator - (pointer As IntPtr, offset As Integer) As IntPtr

Parameter

pointer
IntPtr

nativeint

Die signierte ganze Zahl, von der der Offset subtrahiert werden soll.

offset
Int32

Der Offset, der subtrahiert werden soll.

Gibt zurück

IntPtr

nativeint

Eine neue signierte ganze Zahl, die die Subtraktion von offset von pointer.

Hinweise

Die Subtraction Methode definiert den Subtraktionsvorgang für IntPtr Objekte. Sie aktiviert Code wie z. B. Folgendes.

int[] arr = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20};
unsafe {
   fixed(int* parr = &arr[arr.GetUpperBound(0)])
   {
      IntPtr ptr = new IntPtr(parr);
      for (int ctr = 0; ctr <= arr.GetUpperBound(0); ctr++)
      {
         IntPtr newPtr = ptr - ctr * sizeof(Int32);
         Console.Write("{0}   ", Marshal.ReadInt32(newPtr));
      }
   }
}
// The example displays the following output:
//       20   18   16   14   12   10   8   6   4   2
#nowarn "9"
open System.Runtime.InteropServices
open FSharp.NativeInterop

[<EntryPoint>]
let main _ =
    let arr =
        [| 2; 4; 6; 8; 10; 12; 14; 16; 18; 20 |]

    use parr = fixed &arr[arr.GetUpperBound 0]
    
    let ptr = NativePtr.toNativeInt parr

    for i = 0 to arr.GetUpperBound 0 do
        let newPtr = ptr - nativeint i * nativeint sizeof<int>
        printf $"{Marshal.ReadInt32 newPtr}   "
    0

    // The example displays the following output:
    //       20   18   16   14   12   10   8   6   4   2
Dim arr() As Integer = {2, 4, 6, 8, 10, 12, 14, 16, 18, 20 }
Dim ptr As IntPtr = Marshal.UnsafeAddrOfPinnedArrayElement(arr, arr.GetUpperBound(0))
For ctr As Integer= 0 To arr.GetUpperBound(0)
   Dim newPtr As IntPtr = ptr - ctr * Len(arr(0))
   Console.Write("{0}   ", Marshal.ReadInt32(newPtr))
Next

Sprachen, die keine benutzerdefinierten Operatoren unterstützen, können stattdessen die Subtract Methode aufrufen.

Der Subtraktionsvorgang löst keine Ausnahme aus, wenn das Ergebnis zu klein ist, um als signierte ganze Zahl im Ausführungsprozess darzustellen. Stattdessen wird sie in einem deaktivierten Kontext ausgeführt.

In C# ab Version 11 und bei der Zielbestimmung für die .NET 7 oder höher-Laufzeit ist diese API nur über Spiegelung zugänglich. Der Subtraktionsoperator wird direkt von der Sprache erkannt und folgt dem normalen Sprachverhalten für Subtraktionsvorgänge, einschließlich Überlauf in einem checked Kontext, wenn das Ergebnis zu klein ist, um darzustellen.

Die entsprechende Methode für diesen Operator ist IntPtr.Subtract(IntPtr, Int32)

Gilt für:

Weitere Informationen