IntPtr.Add(IntPtr, Int32) Método
Definição
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 com sinal.
public:
static IntPtr Add(IntPtr pointer, int offset);public static IntPtr Add (IntPtr pointer, int offset);static member Add : nativeint * int -> nativeintPublic Shared Function Add (pointer As IntPtr, offset As Integer) As IntPtrParâmetros
- pointer
-
IntPtr
nativeint
O inteiro com sinal ao qual adicionar o deslocamento.
- offset
- Int32
O deslocamento a ser adicionado.
Retornos
nativeint
Um novo inteiro com sinal que reflete a adição de offset a pointer.
Exemplos
O exemplo a seguir cria uma instância de um IntPtr 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;
using System.Runtime.InteropServices;
public class Example
{
public static void Main()
{
int[] arr = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20 };
unsafe {
fixed(int* parr = arr) {
IntPtr ptr = new IntPtr(parr);
// Get the size of an array element.
int size = sizeof(int);
for (int ctr = 0; ctr < arr.Length; ctr++)
{
IntPtr newPtr = IntPtr.Add(ptr, ctr * size);
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
open System.Runtime.InteropServices
open FSharp.NativeInterop
[<EntryPoint>]
let main _ =
let mutable arr =
[| 2; 4; 6; 8; 10; 12; 14; 16; 18; 20 |]
use parr = fixed arr
let ptr = NativePtr.toNativeInt parr
// Get the size of an array element.
let size = sizeof<int>
for i = 0 to arr.Length - 1 do
let newPtr = IntPtr.Add(ptr, i * size)
printf $"{Marshal.ReadInt32 newPtr} "
0
// The example displays the following output:
// 2 4 6 8 10 12 14 16 18 20
Imports System.Runtime.InteropServices
Module Example
Public Sub Main()
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 = IntPtr.Add(ptr, ctr * Len(arr(0)))
Console.Write("{0} ", Marshal.ReadInt32(newPtr))
Next
End Sub
End Module
' The example displays the following output:
' 2 4 6 8 10 12 14 16 18 20
Comentários
O Add método não gerará uma exceção se o resultado for muito grande para representar como um inteiro com sinal no processo de execução. Em vez disso, a operação de adição é executada em um contexto desmarcado.
Linguagens 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.
