Unsafe.Add メソッド

定義

名前空間:
System.Runtime.CompilerServices
アセンブリ:
System.Runtime.dll
アセンブリ:
System.Runtime.CompilerServices.Unsafe.dll
アセンブリ:
System.Runtime.dll, System.Runtime.CompilerServices.Unsafe.dll

オーバーロード

名前 説明
Add<T>(Void*, Int32)

指定されたアンマネージ ポインターに要素オフセットを追加します。
Add<T>(T, Int32)

指定されたマネージド ポインターにオフセットを追加します。
Add<T>(T, IntPtr)

指定されたマネージド ポインターに要素オフセットを追加します。
Add<T>(T, UIntPtr)

指定されたマネージド ポインターに要素オフセットを追加します。

Add<T>(Void*, Int32)

ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs

重要

この API は CLS 準拠ではありません。

指定されたアンマネージ ポインターに要素オフセットを追加します。

public:
generic <typename T>
 static void* Add(void* source, int elementOffset);
[System.CLSCompliant(false)]
public static void* Add<T>(void* source, int elementOffset) where T : allows ref struct;
public static void* Add<T>(void* source, int elementOffset);
[System.CLSCompliant(false)]
public static void* Add<T>(void* source, int elementOffset);
[<System.CLSCompliant(false)>]
static member Add : nativeptr<unit> * int -> nativeptr<unit>
static member Add : nativeptr<unit> * int -> nativeptr<unit>

型パラメーター

T

サイズが elementOffsetのスケール ファクターとして使用される型。

パラメーター

source
Void*

オフセットを追加するアンマネージ ポインター。

elementOffset
Int32

追加するオフセット。

返品

Void*

指定したオフセットのソース ポインターへの追加を反映する新しいアンマネージ ポインター。

属性
CLSCompliantAttribute

注釈

elementOffset パラメーターは、source ポインターに追加するT サイズの要素の数 (バイト数ではありません) です。 たとえば、ソース ポインター ptr を指定すると、 Unsafe.Add<int>(ptr, 20) 呼び出しは、アドレスが ptr を超える 80 バイト (= 要素あたり 20 要素 * 4 バイト) を指す新しいポインターを返します。

elementOffsetがハードコーディングされたリテラルではなく計算値である場合、呼び出し元は整数オーバーフローの可能性を考慮する必要があります。 たとえば、呼び出しUnsafe.Add<int>(ptr, a * b)では、呼び出し元は中間値a * bInt32の境界をオーバーフローしないようにする必要があります。

適用対象

Add<T>(T, Int32)

ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs

指定されたマネージド ポインターにオフセットを追加します。

public:
generic <typename T>
 static T % Add(T % source, int elementOffset);
public static ref T Add<T>(ref T source, int elementOffset) where T : allows ref struct;
public static ref T Add<T>(ref T source, int elementOffset);
static member Add : 'T * int -> 'T
Public Shared Function Add(Of T) (ByRef source As T, elementOffset As Integer) As T

型パラメーター

T

マネージド ポインターの要素型。

パラメーター

source
T

オフセットを追加するマネージド ポインター。

elementOffset
Int32

追加するオフセット。

返品

T

指定したオフセットのソース ポインターへの追加を反映する新しいマネージド ポインター。

注釈

elementOffset パラメーターは、source ポインターに追加するT サイズの要素の数 (バイト数ではありません) です。 たとえば、ref int型のソース ポインター ptr を指定すると、Unsafe.Add<int>(ref ptr, 20)呼び出しは、アドレスが ptr を超える 80 バイト (= 要素あたり 20 要素 * 4 バイト) を指す新しいポインターを返します。

elementOffsetがハードコーディングされたリテラルではなく計算値である場合、呼び出し元は整数オーバーフローの可能性を考慮する必要があります。 たとえば、呼び出しUnsafe.Add<int>(ref ptr, a * b)では、呼び出し元は中間値a * bInt32の境界をオーバーフローしないようにする必要があります。

適用対象

Add<T>(T, IntPtr)

ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs

指定されたマネージド ポインターに要素オフセットを追加します。

public:
generic <typename T>
 static T % Add(T % source, IntPtr elementOffset);
public static ref T Add<T>(ref T source, IntPtr elementOffset) where T : allows ref struct;
public static ref T Add<T>(ref T source, IntPtr elementOffset);
static member Add : 'T * nativeint -> 'T
Public Shared Function Add(Of T) (ByRef source As T, elementOffset As IntPtr) As T

型パラメーター

T

マネージド ポインターの要素型。

パラメーター

source
T

オフセットを追加するマネージド ポインター。

elementOffset
IntPtr

nativeint

追加するオフセット。

返品

T

指定したオフセットのソース ポインターへの追加を反映する新しいマネージド ポインター。

注釈

elementOffset パラメーターは、source ポインターに追加するT サイズの要素の数 (バイト数ではありません) です。 たとえば、ref int型のソース ポインター ptr を指定すると、Unsafe.Add<int>(ref ptr, (nint)20)呼び出しは、アドレスが ptr を超える 80 バイト (= 要素あたり 20 要素 * 4 バイト) を指す新しいポインターを返します。

elementOffsetがハードコーディングされたリテラルではなく計算値である場合、呼び出し元は整数オーバーフローの可能性を考慮する必要があります。 たとえば、呼び出しUnsafe.Add<int>(ref ptr, a * b)では、呼び出し元は中間値a * bIntPtrの境界をオーバーフローしないようにする必要があります。

適用対象

Add<T>(T, UIntPtr)

ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs
ソース:
Unsafe.cs

重要

この API は CLS 準拠ではありません。

指定されたマネージド ポインターに要素オフセットを追加します。

public:
generic <typename T>
 static T % Add(T % source, UIntPtr elementOffset);
[System.CLSCompliant(false)]
public static ref T Add<T>(ref T source, UIntPtr elementOffset) where T : allows ref struct;
public static ref T Add<T>(ref T source, nuint elementOffset);
[System.CLSCompliant(false)]
public static ref T Add<T>(ref T source, UIntPtr elementOffset);
[<System.CLSCompliant(false)>]
static member Add : 'T * unativeint -> 'T
static member Add : 'T * unativeint -> 'T
Public Shared Function Add(Of T) (ByRef source As T, elementOffset As UIntPtr) As T

型パラメーター

T

マネージド ポインターの要素型。

パラメーター

source
T

オフセットを追加するマネージド ポインター。

elementOffset
UIntPtr

nuint

unativeint

追加するオフセット。

返品

T

指定したオフセットのソース ポインターへの追加を反映する新しいマネージド ポインター。

属性
CLSCompliantAttribute

注釈

elementOffset パラメーターは、source ポインターに追加するT サイズの要素の数 (バイト数ではありません) です。 たとえば、ref int型のソース ポインター ptr を指定すると、Unsafe.Add<int>(ref ptr, (nuint)20)呼び出しは、アドレスが ptr を超える 80 バイト (= 要素あたり 20 要素 * 4 バイト) を指す新しいポインターを返します。

elementOffsetがハードコーディングされたリテラルではなく計算値である場合、呼び出し元は整数オーバーフローの可能性を考慮する必要があります。 たとえば、呼び出しUnsafe.Add<int>(ref ptr, a * b)では、呼び出し元は中間値a * bUIntPtrの境界をオーバーフローしないようにする必要があります。

適用対象