Unsafe.AddByteOffset 方法

定義

命名空間:

System.Runtime.CompilerServices

組件:

System.Runtime.dll

多載

AddByteOffset<T>(T, IntPtr)	將位移新增至指定的Managed指標。
AddByteOffset<T>(T, UIntPtr)	將位移新增至指定的Managed指標。

AddByteOffset<T>(T, IntPtr)

來源:

Unsafe.cs

將位移新增至指定的Managed指標。

public:
generic <typename T>
 static T % AddByteOffset(T % source, IntPtr byteOffset);

public static ref T AddByteOffset<T> (ref T source, IntPtr byteOffset);

static member AddByteOffset : 'T * nativeint -> 'T

Public Shared Function AddByteOffset(Of T) (ByRef source As T, byteOffset As IntPtr) As T

類型參數

T

Managed 指標的專案型別。

參數

source

T

要加入位移的Managed指標。

byteOffset

IntPtr

nativeint

要加上的位移。

傳回

T

新的 Managed 指標，反映將指定的位元組位移新增至來源指標。

備註

參數 byteOffset 是要加入至指標的 source 位元元組數目。 例如，假設類型為 的來源指標 ptrref int，呼叫Unsafe.AddByteOffset<int>(ref ptr, 20)會傳回新的指標，其位址點超過 ptr 20 個字節。

如果 byteOffset 是計算值，而不是硬式編碼常值，呼叫端應該考慮整數溢位的可能性。 例如，在呼叫 中，呼叫 Unsafe.AddByteOffset<int>(ref ptr, a * b)端必須確定中繼值 a * b 不會溢位 的界限 IntPtr。

AddByteOffset<T>(T, UIntPtr)

來源:

Unsafe.cs

重要

此 API 不符合 CLS 規範。

將位移新增至指定的Managed指標。

public:
generic <typename T>
 static T % AddByteOffset(T % source, UIntPtr byteOffset);

[System.CLSCompliant(false)]
public static ref T AddByteOffset<T> (ref T source, UIntPtr byteOffset);

[<System.CLSCompliant(false)>]
static member AddByteOffset : 'T * unativeint -> 'T

Public Shared Function AddByteOffset(Of T) (ByRef source As T, byteOffset As UIntPtr) As T

類型參數

T

Managed 指標的專案型別。

參數

source

T

要加入位移的Managed指標。

byteOffset

UIntPtr

nuint

unativeint

要加上的位移。

傳回

T

新的 Managed 指標，反映將指定的位元組位移新增至來源指標。

屬性

CLSCompliantAttribute

備註

參數 byteOffset 是要加入至指標的 source 位元元組數目。 例如，假設類型為 的來源指標 ptrref int，呼叫Unsafe.AddByteOffset<int>(ref ptr, (nuint)20)會傳回新的指標，其位址點超過 ptr 20 個字節。

如果 byteOffset 是計算值，而不是硬式編碼常值，呼叫端應該考慮整數溢位的可能性。 例如，在呼叫 中，呼叫 Unsafe.AddByteOffset<int>(ref ptr, a * b)端必須確定中繼值 a * b 不會溢位 的界限 UIntPtr。