Unsafe.Add 方法

定义

命名空间:

System.Runtime.CompilerServices

程序集:

System.Runtime.dll

重载

Add<T>(Void*, Int32)	向给定的非托管指针添加元素偏移量。
Add<T>(T, Int32)	向给定的托管指针添加偏移量。
Add<T>(T, IntPtr)	向给定的托管指针添加元素偏移量。
Add<T>(T, UIntPtr)	向给定的托管指针添加元素偏移量。

Add<T>(Void*, Int32)

Source:

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);

[<System.CLSCompliant(false)>]
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) 将返回一个新指针，该指针的地址点为 80 字节 (= 20 个元素 * 4 个字节，每个元素) ptr 之外。

如果 elementOffset 是计算值而不是硬编码文本，则调用方应考虑整数溢出的可能性。 例如，在调用 Unsafe.Add<int>(ptr, a * b)中，调用方必须确保中间值 a * b 不会溢出 的 Int32边界。

Add<T>(T, Int32)

Source:

Unsafe.cs

向给定的托管指针添加偏移量。

public:
generic <typename T>
 static T % Add(T % source, int elementOffset);

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)将返回一个新指针，该指针的地址点为 80 字节 (= 20 个元素 * 4 个字节，每个元素) 超出 ptr。

如果 elementOffset 是计算值而不是硬编码文本，则调用方应考虑整数溢出的可能性。 例如，在调用 Unsafe.Add<int>(ref ptr, a * b)中，调用方必须确保中间值 a * b 不会溢出 的 Int32边界。

Add<T>(T, IntPtr)

Source:

Unsafe.cs

向给定的托管指针添加元素偏移量。

public:
generic <typename T>
 static T % Add(T % source, IntPtr elementOffset);

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)将返回一个新指针，该指针的地址点为 80 字节 (= 20 个元素 * 4 个字节，每个元素) 超出 ptr。

如果 elementOffset 是计算值而不是硬编码文本，则调用方应考虑整数溢出的可能性。 例如，在调用 Unsafe.Add<int>(ref ptr, a * b)中，调用方必须确保中间值 a * b 不会溢出 的 IntPtr边界。

Add<T>(T, UIntPtr)

Source:

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);

[<System.CLSCompliant(false)>]
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)将返回一个新指针，该指针的地址点为 80 字节 (= 20 个元素 * 4 个字节，每个元素) 超出 ptr。

如果 elementOffset 是计算值而不是硬编码文本，则调用方应考虑整数溢出的可能性。 例如，在调用 Unsafe.Add<int>(ref ptr, a * b)中，调用方必须确保中间值 a * b 不会溢出 的 UIntPtr边界。