Unsafe.Add Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
Add<T>(Void*, Int32) |
Добавляет смещение элемента в заданный неуправляемый указатель. |
Add<T>(T, Int32) |
Добавляет смещение к заданному управляемому указателю. |
Add<T>(T, IntPtr) |
Добавляет смещение элемента в заданный управляемый указатель. |
Add<T>(T, UIntPtr) |
Добавляет смещение элемента в заданный управляемый указатель. |
Add<T>(Void*, Int32)
Важно!
Этот API несовместим с CLS.
Добавляет смещение элемента в заданный неуправляемый указатель.
public:
generic <typename T>
static void* Add(void* source, int elementOffset);
public static void* Add<T> (void* source, int elementOffset);
[System.CLSCompliant(false)]
public static void* Add<T> (void* source, int elementOffset);
static member Add : nativeptr<unit> * int -> nativeptr<unit>
[<System.CLSCompliant(false)>]
static member Add : nativeptr<unit> * int -> nativeptr<unit>
Параметры типа
- T
Тип, размер которого будет использоваться в качестве коэффициента масштабирования.elementOffset
Параметры
- source
- Void*
Неуправляемый указатель, в который добавляется смещение.
- elementOffset
- Int32
Добавляемое смещение.
Возвращаемое значение
- Void*
Новый неуправляемый указатель, который отражает добавление указанного смещения к исходному указателю.
- Атрибуты
Комментарии
Параметр elementOffset
— это количество T
элементов размера (не байтов), добавляемых в source
указатель. Например, при указании ptr исходного указателя вызов Unsafe.Add<int>(ptr, 20)
возвращает новый указатель, адрес которого 80 байт (= 20 элементов * 4 байта на элемент) за пределами ptr.
Если elementOffset
это вычисляемое значение, а не жестко закодированный литерал, вызывающие абоненты должны рассмотреть возможность переполнения целых чисел. Например, в вызове Unsafe.Add<int>(ptr, a * b)
вызывающий объект должен убедиться, что промежуточное значение a * b
не переполняет границы Int32
.
Применяется к
Add<T>(T, Int32)
Добавляет смещение к заданному управляемому указателю.
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
— это количество T
элементов размера (не байтов), добавляемых в source
указатель. Например, при указании типа ptr исходного ref int
указателя вызов 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)
Добавляет смещение элемента в заданный управляемый указатель.
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
— это количество T
элементов размера (не байтов), добавляемых в source
указатель. Например, при указании типа ptr исходного ref int
указателя вызов 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)
Важно!
Этот API несовместим с CLS.
Добавляет смещение элемента в заданный управляемый указатель.
public:
generic <typename T>
static T % Add(T % source, UIntPtr elementOffset);
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);
static member Add : 'T * unativeint -> 'T
[<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
Новый управляемый указатель, который отражает добавление указанного смещения к исходному указателю.
- Атрибуты
Комментарии
Параметр elementOffset
— это количество T
элементов размера (не байтов), добавляемых в source
указатель. Например, при указании типа ptr исходного ref int
указателя вызов Unsafe.Add<int>(ref ptr, (nuint)20)
вернет новый указатель, адрес которого равно 80 байтам (= 20 элементов * 4 байта на элемент) за пределами ptr.
Если elementOffset
это вычисляемое значение, а не жестко закодированный литерал, вызывающие абоненты должны рассмотреть возможность переполнения целых чисел. Например, в вызове Unsafe.Add<int>(ref ptr, a * b)
вызывающий объект должен убедиться, что промежуточное значение a * b
не переполняет границы UIntPtr
.