UIntPtr.Add(UIntPtr, Int32) Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona um deslocamento a um inteiro sem sinal.

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

Parâmetros

pointer: UIntPtr
unativeint

O inteiro sem sinal ao qual adicionar o deslocamento.

offset: Int32

O deslocamento a ser adicionado.

Retornos

UIntPtr unativeint

Um novo inteiro sem sinal que reflete a adição de offset .pointer

Exemplos

O exemplo a seguir cria uma instância de um UIntPtr objeto que aponta para o início de uma matriz de dez elementos e, em seguida, chama o Add método para iterar os elementos na matriz.

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

Comentários

O Add método não gerará uma exceção se o resultado for muito grande para representar como um inteiro sem sinal no processo de execução. Em vez disso, a operação de adição é executada em um contexto desmarcado.

Idiomas que não dão suporte à sobrecarga de operador ou operadores personalizados podem usar esse método para adicionar um deslocamento ao valor de um ponteiro.

Aplica-se a

Confira também

Addition(UIntPtr, Int32)

Partilhar via