ReadOnlySpan<T> Структура

Ссылка

Определение

Пространство имен:: System

Сборка:: System.Runtime.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет типобезопасную и безопасную для памяти реализацию непрерывной области произвольной памяти только для чтения.

generic <typename T>
public value class ReadOnlySpan

public readonly ref struct ReadOnlySpan<T>

type ReadOnlySpan<'T> = struct

Public Structure ReadOnlySpan(Of T)

Параметры типа

T

Тип элементов в .ReadOnlySpan<T>

Наследование: Object

ValueType
ReadOnlySpan<T>

ReadOnlySpan<T> — это структура ссылок , выделенная в стеке и никогда не может экранироваться в управляемую кучу. Типы структур ссылок имеют ряд ограничений, чтобы они не могли быть повышены до управляемой кучи, включая их невозможно упаковать в лямбда-выражения, назначенные переменным типа Object, назначенные переменным, назначенные dynamic переменным, и они не могут реализовать какой-либо тип интерфейса.

ReadOnlySpan<T> Экземпляр часто используется для ссылки на элементы массива или части массива. В отличие от массива, ReadOnlySpan<T> экземпляр может указывать на управляемую память, собственную память или память, управляемую в стеке.

Конструкторы

ReadOnlySpan<T>(T[])	Создает новый объект ReadOnlySpan<T> по всему указанному массиву.
ReadOnlySpan<T>(T[], Int32, Int32)	Создает новый объект ReadOnlySpan<T>, который включает указанное число элементов массива, начиная с указанного индекса.
ReadOnlySpan<T>(Void*, Int32)	Создает объект ReadOnlySpan<T> из указанного числа элементов `T`, начиная с заданного адреса памяти.

Свойства

Empty	Возвращает пустой массив ReadOnlySpan<T>.
IsEmpty	Возвращает значение, указывающее на то, что текущий диапазон только для чтения пуст.
Item[Int32]	Возвращает элемент из диапазона только для чтения по начинающемуся с нуля индексу.
Length	Количество элементов в диапазоне только для чтения.

Методы

CopyTo(Span<T>)	Копирует содержимое этого объекта ReadOnlySpan<T> в назначение Span<T>.
Equals(Object)	Является устаревшей. Является устаревшей. Не поддерживается. Создает исключение NotSupportedException.
GetEnumerator()	Возвращает перечислитель для коллекции ReadOnlySpan<T>.
GetHashCode()	Является устаревшей. Не поддерживается. Создает исключение NotSupportedException.
GetPinnableReference()	Возвращает ссылку только для чтения на объект типа T, который можно использовать для закрепления. Этот метод предназначен для поддержки .NET компиляторов и не предназначен для вызова пользовательским кодом.
Slice(Int32)	Формирует срез вне текущего диапазона только для чтения, который начинается с указанного индекса.
Slice(Int32, Int32)	Формирует срез вне текущего диапазона только для чтения, начиная с указанного индекса до указанной длины.
ToArray()	Копирует содержимое этого диапазона только для чтения в новый массив.
ToString()	Возвращает строковое представление объекта ReadOnlySpan<T>.
TryCopyTo(Span<T>)	Пытается копировать содержимое этого объекта ReadOnlySpan<T> в Span<T> и возвращает значение, указывающее, была ли выполнена операция.

Операторы

Equality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Возвращает значение, указывающее, равны ли два экземпляра ReadOnlySpan<T>.
Implicit(ArraySegment<T> to ReadOnlySpan<T>)	Определяет неявное преобразование ArraySegment<T> в ReadOnlySpan<T>.
Implicit(T[] to ReadOnlySpan<T>)	Определяет неявное преобразование массива в ReadOnlySpan<T>.
Inequality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Возвращает значение, указывающее, равны ли два экземпляра ReadOnlySpan<T>.

Методы расширения

ToImmutableArray<T>(ReadOnlySpan<T>)	Создает неизменяемый массив содержимого из указанных элементов.
BinarySearch<T>(ReadOnlySpan<T>, IComparable<T>)	Выполняет поиск значения во всем отсортированном массиве ReadOnlySpan<T>, используя заданный универсальный интерфейс IComparable<T>.
BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)	Выполняет поиск указанного значения во всем отсортированном массиве ReadOnlySpan<T>, используя заданный универсальный тип `TComparer`.
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)	Выполняет поиск значения во всем отсортированном массиве ReadOnlySpan<T>, используя заданный универсальный тип `TComparable`.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Находит длину общего префикса, совместно используемого между `span` и `other`.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Определяет длину всех общих префиксов, совместно используемых между `span` и `other`.
Contains<T>(ReadOnlySpan<T>, T)	Указывает, найдено ли указанное значение в диапазоне, доступном только для чтения. Значения сравниваются с помощью IEquatable {T}.Equals (T).
EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Определяет, отображается ли указанная последовательность в конце диапазона, доступного только для чтения.
IndexOf<T>(ReadOnlySpan<T>, T)	Выполняет поиск указанного значения и возвращает индекс его первого вхождения. Значения сравниваются с помощью IEquatable {T}.Equals (T).
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск указанной последовательности и возвращает индекс ее первого вхождения. Значения сравниваются с помощью IEquatable {T}.Equals (T).
IndexOfAny<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск первого индекса любого из указанных значений аналогичного вызову IndexOf несколько раз с помощью логического оператора ИЛИ.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск первого индекса любого из указанных значений аналогичного вызову IndexOf несколько раз с помощью логического оператора ИЛИ.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск первого индекса любого из указанных значений аналогичного вызову IndexOf несколько раз с помощью логического оператора ИЛИ.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Выполняет поиск первого индекса любого значения, отличного от указанного `value`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск первого индекса любого значения, отличного от указанного `value0` или `value1`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск первого индекса любого значения, отличного от указанного `value0`, `value1`или `value2`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск первого индекса любого значения, отличного от указанного `values`.
LastIndexOf<T>(ReadOnlySpan<T>, T)	Выполняет поиск указанного значения и возвращает индекс его последнего вхождения. Значения сравниваются с помощью IEquatable {T}.Equals (T).
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск указанной последовательности и возвращает индекс ее последнего вхождения. Значения сравниваются с помощью IEquatable {T}.Equals (T).
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск последнего индекса любого из указанных значений аналогичного вызову LastIndexOf несколько раз с помощью логического оператора ИЛИ.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск последнего индекса любого из указанных значений аналогичного вызову LastIndexOf несколько раз с помощью логического оператора ИЛИ.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск последнего индекса любого из указанных значений аналогичного вызову LastIndexOf несколько раз с помощью логического оператора ИЛИ.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Выполняет поиск последнего индекса любого значения, отличного от указанного `value`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск последнего индекса любого значения, отличного от указанного или `value1`.`value0`
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск последнего индекса любого значения, отличного от указанного `value0`, `value1`или `value2`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск последнего индекса любого значения, отличного от указанного `values`.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Определяет, перекрываются ли две последовательности только для чтения в памяти.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, Int32)	Определяет, перекрываются ли две последовательности только для чтения в памяти, и выводит смещение элементов.
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Определяет относительный порядок двух последовательностей только для чтения путем сравнения их элементов с помощью IComparable{T}.CompareTo (T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Определяет, равны ли две последовательности только для чтения, сравнивая элементы с помощью IEquatable{T}.Equals (T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Определяет, равны ли две последовательности путем сравнения элементов с помощью .IEqualityComparer<T>
StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Определяет, отображается ли указанная последовательность в начале диапазона, доступного только для чтения.
Trim<T>(ReadOnlySpan<T>, T)	Удаляет все начальные и конечные вхождения указанного элемента из диапазона только для чтения.
Trim<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Удаляет все начальные и конечные вхождения набора элементов, указанного в диапазоне только для чтения, из диапазона только для чтения.
TrimEnd<T>(ReadOnlySpan<T>, T)	Удаляет все конечные вхождения указанного элемента из диапазона только для чтения.
TrimEnd<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Удаляет все конечные вхождения набора элементов, указанного в диапазоне только для чтения, из диапазона только для чтения.
TrimStart<T>(ReadOnlySpan<T>, T)	Удаляет все начальные вхождения указанного элемента из диапазона.
TrimStart<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Удаляет все начальные вхождения набора элементов, указанного в диапазоне только для чтения, из диапазона.

Применяется к