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

Ссылка

Определение

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

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

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

Сборка:: netstandard.dll

Пакет:: System.Memory v4.5.5

Исходный код:: ReadOnlySpan.cs

Исходный код:: ReadOnlySpan.cs

Исходный код:: ReadOnlySpan.cs

Важно!

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

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

generic <typename T>
public value class ReadOnlySpan

public readonly ref struct ReadOnlySpan<T>

[System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))]
public readonly ref struct ReadOnlySpan<T>

type ReadOnlySpan<'T> = struct

[<System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))>]
type ReadOnlySpan<'T> = struct

Public Structure ReadOnlySpan(Of T)

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

T

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

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

ValueType
ReadOnlySpan<T>

Атрибуты: NativeMarshallingAttribute

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

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

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

ReadOnlySpan<T>(T)	Создает новую ReadOnlySpan<T> длины 1 вокруг указанной ссылки.
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	Количество элементов в диапазоне только для чтения.

Методы

CastUp<TDerived>(ReadOnlySpan<TDerived>)	Приводит диапазон `TDerived` только для чтения к диапазону `T`только для чтения.
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).
ContainsAny<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск экземпляра `value0` или `value1`.
ContainsAny<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск экземпляра `value0`, `value1`или `value2`.
ContainsAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Выполняет поиск любого из указанных `values`.
ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск любого из указанных `values`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T)	Выполняет поиск любого значения, отличного от указанного `value`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск любого значения, отличного от `value0` или `value1`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск любого значения, отличного от `value0`, `value1`или `value2`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Выполняет поиск любого значения, отличного от указанного `values`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск любого значения, отличного от указанного `values`.
ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Ищет любое значение за пределами диапазона между `lowInclusive` и `highInclusive`включительно.
ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T)	Ищет любое значение в диапазоне между `lowInclusive` и `highInclusive`включительно.
Count<T>(ReadOnlySpan<T>, T)	Подсчитывает количество указанных `value` в `span`.
Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Подсчитывает количество `value` в `span`.
EndsWith<T>(ReadOnlySpan<T>, 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 несколько раз с помощью логического оператора OR.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск первого индекса любого из указанных значений, аналогичных вызову IndexOf несколько раз с помощью логического оператора OR.
IndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Выполняет поиск первого индекса любого из указанных значений.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск первого индекса любого из указанных значений, аналогичных вызову IndexOf несколько раз с помощью логического оператора OR.
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>, SearchValues<T>)	Выполняет поиск первого индекса любого значения, отличного от указанного `values`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск первого индекса любого значения, отличного от указанного `values`.
IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск первого индекса любого значения вне диапазона между `lowInclusive` и `highInclusive`включительно.
IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск первого индекса любого значения в диапазоне между `lowInclusive` и `highInclusive`включительно.
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 несколько раз с логическим оператором OR.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск последнего индекса любого из указанных значений, аналогичных вызову LastIndexOf несколько раз с логическим оператором OR.
LastIndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Выполняет поиск последнего индекса любого из указанных значений.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск последнего индекса любого из указанных значений, аналогичных вызову LastIndexOf несколько раз с логическим оператором OR.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Выполняет поиск последнего индекса любого значения, отличного от указанного `value`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Выполняет поиск последнего индекса любого значения, отличного от указанного `value0` или `value1`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Выполняет поиск последнего индекса любого значения, отличного от указанного `value0`, `value1`или `value2`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Выполняет поиск последнего индекса любого значения, отличного от указанного `values`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Выполняет поиск последнего индекса любого значения, отличного от указанного `values`.
LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Ищет последний индекс любого значения вне диапазона между `lowInclusive` и `highInclusive`включительно.
LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Ищет последний индекс любого значения в диапазоне от `lowInclusive` до `highInclusive`включительно.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Определяет, перекрываются ли две последовательности только для чтения в памяти.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, Int32)	Определяет, перекрываются ли две последовательности только для чтения в памяти и выводит смещение элемента.
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T)	Копирует `source` в `destination`, заменяя все вхождения `oldValuenewValue`.
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>.
Split<T>(ReadOnlySpan<T>, T)	Предоставляет типобезопасное и безопасное для чтения представление непрерывной области произвольной памяти.
Split<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Предоставляет типобезопасное и безопасное для чтения представление непрерывной области произвольной памяти.
SplitAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Предоставляет типобезопасное и безопасное для чтения представление непрерывной области произвольной памяти.
SplitAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Предоставляет типобезопасное и безопасное для чтения представление непрерывной области произвольной памяти.
StartsWith<T>(ReadOnlySpan<T>, 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>)	Удаляет все начальные вхождения набора элементов, указанных в диапазоне только для чтения, из диапазона.

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

См. также раздел

типы, связанные с памятью и диапазоном,
<памяти T> и рекомендации по использованию><>

Поделиться через