Unsafe.Subtract Método

Definição

Namespace:

System.Runtime.CompilerServices

Assembly:

System.Runtime.dll

Pacote:

System.Runtime.CompilerServices.Unsafe v6.0.0

Sobrecargas

Subtract<T>(Void*, Int32)	Subtrai um deslocamento de elemento do ponteiro não gerenciado fornecido.
Subtract<T>(T, Int32)	Subtrai um deslocamento do ponteiro gerenciado fornecido.
Subtract<T>(T, IntPtr)	Subtrai um deslocamento de elemento do ponteiro gerenciado fornecido.
Subtract<T>(T, UIntPtr)	Subtrai um deslocamento de elemento do ponteiro gerenciado fornecido.

Subtract<T>(Void*, Int32)

Origem:

Unsafe.cs

Importante

Esta API não está em conformidade com CLS.

Subtrai um deslocamento de elemento do ponteiro não gerenciado fornecido.

public:
generic <typename T>
 static void* Subtract(void* source, int elementOffset);

[System.CLSCompliant(false)]
public static void* Subtract<T> (void* source, int elementOffset);

[<System.CLSCompliant(false)>]
static member Subtract : nativeptr<unit> * int -> nativeptr<unit>

Parâmetros de tipo

T

O tipo cujo tamanho será usado como um fator de escala para elementOffset.

Parâmetros

source

Void*

O ponteiro não gerenciado do qual subtrair o deslocamento.

elementOffset

Int32

O deslocamento a ser subtraído.

Retornos

Void*

Um novo ponteiro não gerenciado que reflete a subtração do deslocamento especificado do ponteiro de origem.

Atributos

CLSCompliantAttribute

Comentários

O elementOffset parâmetro é o número de Telementos do tamanho (não bytes) a serem removidos do source ponteiro. Por exemplo, dado um ponteiro de origem ptr, a chamada Unsafe.Subtract<int>(ptr, 20) retornará um novo ponteiro cujo endereço aponta 80 bytes (= 20 elementos * 4 bytes por elemento) antes de ptr.

Se elementOffset for um valor calculado em vez de um literal codificado, os chamadores devem considerar a possibilidade de estouro inteiro. Por exemplo, na chamada Unsafe.Subtract<int>(ptr, a * b), o chamador deve garantir que o valor a * b intermediário não transborde os limites de Int32.

Subtract<T>(T, Int32)

Origem:

Unsafe.cs

Subtrai um deslocamento do ponteiro gerenciado fornecido.

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

public static ref T Subtract<T> (ref T source, int elementOffset);

static member Subtract : 'T * int -> 'T

Public Shared Function Subtract(Of T) (ByRef source As T, elementOffset As Integer) As T

Parâmetros de tipo

T

O tipo elemental do ponteiro gerenciado.

Parâmetros

source

T

O ponteiro gerenciado do qual subtrair o deslocamento.

elementOffset

Int32

O deslocamento a ser subtraído.

Retornos

T

Um novo ponteiro gerenciado que reflete a subtração do deslocamento especificado do ponteiro de origem.

Comentários

O elementOffset parâmetro é o número de Telementos de tamanho (não bytes) a serem subtraídos do source ponteiro. Por exemplo, dado um ptr de ponteiro de origem do tipo ref int, a chamada Unsafe.Subtract<int>(ref ptr, 20) retornará um novo ponteiro cujo endereço aponta 80 bytes (= 20 elementos * 4 bytes por elemento) antes de ptr.

Se elementOffset for um valor calculado em vez de um literal codificado, os chamadores devem considerar a possibilidade de estouro inteiro. Por exemplo, na chamada Unsafe.Subtract<int>(ref ptr, a * b), o chamador deve garantir que o valor a * b intermediário não transborde os limites de Int32.

Subtract<T>(T, IntPtr)

Origem:

Unsafe.cs

Subtrai um deslocamento de elemento do ponteiro gerenciado fornecido.

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

public static ref T Subtract<T> (ref T source, IntPtr elementOffset);

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

Public Shared Function Subtract(Of T) (ByRef source As T, elementOffset As IntPtr) As T

Parâmetros de tipo

T

O tipo elemental do ponteiro gerenciado.

Parâmetros

source

T

O ponteiro gerenciado do qual subtrair o deslocamento.

elementOffset

IntPtr

nativeint

O deslocamento a ser subtraído.

Retornos

T

Um novo ponteiro gerenciado que reflete a subtração do deslocamento especificado do ponteiro de origem.

Comentários

O elementOffset parâmetro é o número de Telementos de tamanho (não bytes) a serem subtraídos do source ponteiro. Por exemplo, dado um ptr de ponteiro de origem do tipo ref int, a chamada Unsafe.Subtract<int>(ref ptr, (nint)20) retornará um novo ponteiro cujo endereço aponta 80 bytes (= 20 elementos * 4 bytes por elemento) antes de ptr.

Se elementOffset for um valor calculado em vez de um literal codificado, os chamadores devem considerar a possibilidade de estouro inteiro. Por exemplo, na chamada Unsafe.Subtract<int>(ref ptr, a * b), o chamador deve garantir que o valor a * b intermediário não transborde os limites de IntPtr.

Subtract<T>(T, UIntPtr)

Origem:

Unsafe.cs

Importante

Esta API não está em conformidade com CLS.

Subtrai um deslocamento de elemento do ponteiro gerenciado fornecido.

public:
generic <typename T>
 static T % Subtract(T % source, UIntPtr elementOffset);

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

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

Public Shared Function Subtract(Of T) (ByRef source As T, elementOffset As UIntPtr) As T

Parâmetros de tipo

T

O tipo elemental do ponteiro gerenciado.

Parâmetros

source

T

O ponteiro gerenciado do qual subtrair o deslocamento.

elementOffset

UIntPtr

nuint

unativeint

O deslocamento a ser subtraído.

Retornos

T

Um novo ponteiro gerenciado que reflete a subtração do deslocamento especificado do ponteiro de origem.

Atributos

CLSCompliantAttribute

Comentários

O elementOffset parâmetro é o número de Telementos de tamanho (não bytes) a serem subtraídos do source ponteiro. Por exemplo, dado um ptr de ponteiro de origem do tipo ref int, a chamada Unsafe.Subtract<int>(ref ptr, (nuint)20) retornará um novo ponteiro cujo endereço aponta 80 bytes (= 20 elementos * 4 bytes por elemento) antes de ptr.

Se elementOffset for um valor calculado em vez de um literal codificado, os chamadores devem considerar a possibilidade de estouro inteiro. Por exemplo, na chamada Unsafe.Subtract<int>(ref ptr, a * b), o chamador deve garantir que o valor a * b intermediário não transborde os limites de UIntPtr.