UIntPtr.Addition(UIntPtr, Int32) Operator

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Source:

UIntPtr.cs

Adds an offset to an unsigned integer.

public:
 static UIntPtr operator +(UIntPtr pointer, int offset);

public static UIntPtr operator + (UIntPtr pointer, int offset);

static member ( + ) : unativeint * int -> unativeint

Public Shared Operator + (pointer As UIntPtr, offset As Integer) As UIntPtr

Parameters

pointer

UIntPtr

unativeint

The unsigned integer to add the offset to.

offset

Int32

The offset to add.

Returns

UIntPtr

unativeint

A new unsigned integer that reflects the addition of offset to pointer.

Remarks

The Addition method defines the addition operation for UIntPtr objects. It enables code such as the following.

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 = ptr + ctr;
   Console.WriteLine(newPtr);
}

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 = ptr + UIntPtr(uint i)
    printfn $"{newPtr}"

Dim arr() As Integer = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10 }
Dim ptr = CType(arr(0), UIntPtr)
For ctr As Integer = 0 To arr.Length - 1
   Dim newPtr As UIntPtr = ptr + ctr
   Console.WriteLine(newPtr)
Next

Languages that do not support custom operators can call the Add method instead.

The addition operation does not throw an exception if the result is too large to represent as an unsigned integer in the executing process. Instead, it is performed in an unchecked context.

In C# starting from version 11 and when targeting the .NET 7 or later runtime, this API is only accessible via reflection. The addition operator is directly recognized by the language and will follow the normal language behavior for addition operations, including overflowing in a checked context if the result is too large to represent.

The equivalent method for this operator is UIntPtr.Add(UIntPtr, Int32).

See also

• Add(UIntPtr, Int32)