IntPtr.Subtraction(IntPtr, Int32) Operator

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

Odejmuje przesunięcie z podpisanej liczby całkowitej.

public:
 static IntPtr operator -(IntPtr pointer, int offset);

public static IntPtr operator - (IntPtr pointer, int offset);

static member ( - ) : nativeint * int -> nativeint

Public Shared Operator - (pointer As IntPtr, offset As Integer) As IntPtr

Parametry

pointer

IntPtr

nativeint

Podpisana liczba całkowita do odejmowania przesunięcia od.

offset

Int32

Przesunięcie w celu odejmowania.

Zwraca

IntPtr

nativeint

Nowa podpisana liczba całkowita, która odzwierciedla odejmowanie wartości offset z pointerelementu .

Uwagi

Metoda Subtraction definiuje operację odejmowania dla IntPtr obiektów. Umożliwia on kod, taki jak poniższy.

int[] arr = { 2, 4, 6, 8, 10, 12, 14, 16, 18, 20};
unsafe {
   fixed(int* parr = &arr[arr.GetUpperBound(0)])
   {
      IntPtr ptr = new IntPtr(parr);
      for (int ctr = 0; ctr <= arr.GetUpperBound(0); ctr++)
      {
         IntPtr newPtr = ptr - ctr * sizeof(Int32);
         Console.Write("{0}   ", Marshal.ReadInt32(newPtr));
      }
   }
}
// The example displays the following output:
//       20   18   16   14   12   10   8   6   4   2

#nowarn "9"
open System.Runtime.InteropServices
open FSharp.NativeInterop

[<EntryPoint>]
let main _ =
    let arr =
        [| 2; 4; 6; 8; 10; 12; 14; 16; 18; 20 |]

    use parr = fixed &arr[arr.GetUpperBound 0]
    
    let ptr = NativePtr.toNativeInt parr

    for i = 0 to arr.GetUpperBound 0 do
        let newPtr = ptr - nativeint i * nativeint sizeof<int>
        printf $"{Marshal.ReadInt32 newPtr}   "
    0

    // The example displays the following output:
    //       20   18   16   14   12   10   8   6   4   2

Dim arr() As Integer = {2, 4, 6, 8, 10, 12, 14, 16, 18, 20 }
Dim ptr As IntPtr = Marshal.UnsafeAddrOfPinnedArrayElement(arr, arr.GetUpperBound(0))
For ctr As Integer= 0 To arr.GetUpperBound(0)
   Dim newPtr As IntPtr = ptr - ctr * Len(arr(0))
   Console.Write("{0}   ", Marshal.ReadInt32(newPtr))
Next

Języki, które nie obsługują operatorów niestandardowych, mogą zamiast tego wywoływać metodę Subtract .

Operacja odejmowania nie zgłasza wyjątku, jeśli wynik jest zbyt mały do reprezentowania jako podpisana liczba całkowita w procesie wykonywania. Zamiast tego jest wykonywany w nieznakowanym kontekście.

W języku C# począwszy od wersji 11 i w przypadku określania wartości docelowej środowiska uruchomieniowego .NET 7 lub nowszego ten interfejs API jest dostępny tylko za pośrednictwem odbicia. Operator odejmowania jest rozpoznawany bezpośrednio przez język i będzie postępować zgodnie z normalnym zachowaniem checked języka dla operacji odejmowania, w tym przepełnieniem w kontekście, jeśli wynik jest zbyt mały do reprezentowania.

Równoważna metoda dla tego operatora to IntPtr.Subtract(IntPtr, Int32)

Zobacz też

• Subtract(IntPtr, Int32)