UIntPtr.Add(UIntPtr, Int32) Methode

  • Referenz

Definition

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

Fügt einen Offset zu einer nicht signierten ganzzahligen Zahl hinzu.

public:
 static UIntPtr Add(UIntPtr pointer, int offset);
public static UIntPtr Add (UIntPtr pointer, int offset);
static member Add : unativeint * int -> unativeint
Public Shared Function Add (pointer As UIntPtr, offset As Integer) As UIntPtr

Parameter

pointer
UIntPtr

unativeint

Die nicht signierte ganze Zahl, der der Offset hinzugefügt werden soll.

offset
Int32

Der Offset, der addiert werden soll.

Gibt zurück

UIntPtr

unativeint

Eine neue unsignierte ganze Zahl, die die Ergänzung zu offset pointer.

Beispiele

Im folgenden Beispiel wird ein UIntPtr Objekt instanziiert, das auf den Anfang eines Zehn-Element-Arrays verweist, und ruft dann die Add Methode auf, um die Elemente im Array zu durchlaufen.

using System;

public class Example
{
   public static void Main()
   {
      int[] arr = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 };
      UIntPtr ptr = (UIntPtr) arr[0];
      for (int ctr = 0; ctr < arr.Length; ctr++)
      {
         UIntPtr newPtr = UIntPtr.Add(ptr, ctr);
         Console.Write("{0}   ", newPtr);
      }      
   }
}
// The example displays the following output:
//       1   2   3   4   5   6   7   8   9   10

open System

let arr = [| 1; 2; 3; 4; 5; 6; 7; 8; 9; 10 |]
let ptr = UIntPtr(uint arr[0])
for i = 0 to arr.Length - 1 do
    let newPtr = UIntPtr.Add(ptr, i)
    printf $"{newPtr}   "
// The example displays the following output:
//       1   2   3   4   5   6   7   8   9   10

Module Example
   Public Sub Main()
      Dim arr() As Integer = { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
      Dim ptr As UIntPtr = CType(arr(0), UIntPtr)
      For ctr As Integer= 0 To arr.Length - 1
         Dim newPtr As UIntPtr = UIntPtr.Add(ptr, ctr)
         Console.Write("{0}   ", newPtr)
      Next
   End Sub
End Module
' The example displays the following output:
'       1   2   3   4   5   6   7   8   9   10

Hinweise

Die Add Methode löst keine Ausnahme aus, wenn das Ergebnis zu groß ist, um als nicht signierte ganze Zahl im Ausführungsprozess darzustellen. Stattdessen wird der Zusatzvorgang in einem deaktivierten Kontext ausgeführt.

Sprachen, die keine Operatorüberladung oder benutzerdefinierte Operatoren unterstützen, können diese Methode verwenden, um dem Wert eines Zeigers einen Offset hinzuzufügen.

Gilt für

Siehe auch