UIntPtr.Add(UIntPtr, Int32) UIntPtr.Add(UIntPtr, Int32) UIntPtr.Add(UIntPtr, Int32) UIntPtr.Add(UIntPtr, Int32) Method

定義

符号なしポインターの値にオフセットを加算します。Adds an offset to the value of an unsigned pointer.

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

パラメーター

pointer
UIntPtr UIntPtr UIntPtr UIntPtr

オフセットを加算する符号なしポインター。The unsigned pointer to add the offset to.

offset
Int32 Int32 Int32 Int32

加算するオフセット。The offset to add.

戻り値

offset への pointer の加算が反映された新しい符号なしポインター。A new unsigned pointer that reflects the addition of offset to pointer.

次の例ではUIntPtr 、10要素の配列の先頭を指すオブジェクトをインスタンス化し、 Addメソッドを呼び出して配列内の要素を反復処理します。The following example instantiates a UIntPtr object that points to the beginning of a ten-element array, and then calls the Add method to iterate the elements in the array.

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
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

注釈

結果Addが大きすぎて指定されたプラットフォーム上のポインターとして表現できない場合、メソッドは例外をスローしません。The Add method does not throw an exception if the result is too large to represent as a pointer on the specified platform. 代わりに、追加操作は unchecked コンテキストで実行されます。Instead, the addition operation is performed in an unchecked context.

演算子のオーバーロードまたはカスタム演算子をサポートしない言語では、このメソッドを使用して、符号なしポインターの値にオフセットを追加できます。Languages that do not support operator overloading or custom operators can use this method to add an offset to the value of an unsigned pointer.

適用対象

こちらもご覧ください