IntPtr.Addition(IntPtr, Int32) Betreiber

  • Referenz

Definition

Namespace:
System
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Fügt einen Offset zu einer signierten Ganzzahl hinzu.

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, um den Offset hinzuzufügen.

offset
Int32

Der Offset, der addiert werden soll.

Gibt zurück

IntPtr

nativeint

Eine neue signierte ganze Zahl, die die Ergänzung von offset pointer.

Hinweise

Die Addition Methode definiert den Ergänzungsvorgang für IntPtr Objekte. Es ermöglicht Code wie das folgende.

int[] arr = {2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
unsafe {
   fixed(int* parr = arr)
   {
       IntPtr ptr = new IntPtr(parr);
       for (int ctr = 0; ctr < arr.Length; ctr++)
       {
          IntPtr newPtr = ptr + ctr * sizeof(Int32);
          Console.Write("{0}   ", Marshal.ReadInt32(newPtr));
       }
   }
}
// The example displays the following output:
//       2   4   6   8   10   12   14   16   18   20

#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

    let ptr = NativePtr.toNativeInt parr

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

    // The example displays the following output:
    //       2   4   6   8   10   12   14   16   18   20

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

Sprachen, die benutzerdefinierte Operatoren nicht unterstützen, können stattdessen die Add Methode aufrufen.

Der Ergänzungsvorgang löst keine Ausnahme aus, wenn das Ergebnis zu groß ist, um als signierte ganze Zahl im Ausführungsprozess darzustellen. Stattdessen wird es in einem deaktivierten Kontext ausgeführt.

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

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

Gilt für

Siehe auch