ReadOnlySpan<T> 結構

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

ReadOnlySpan.cs

提供任意記憶體連續區域的類型安全與記憶體安全只讀表示。

generic <typename T>
public value class ReadOnlySpan

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

[<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> 是堆疊上配置的 ref 結構，且永遠無法逸出至 Managed 堆積。 Ref 結構類型有一些限制，以確保它們無法升階到 Managed 堆積，包括無法在 Lambda 表達式中擷取它們、指派給類型 Object變數、指派給 dynamic 變數，而且無法實作任何介面類型。

ReadOnlySpan<T> 實例通常用來參考數位或數位部分的專案。 不過，不同於陣列，ReadOnlySpan<T> 實例可以指向堆疊上管理的記憶體、原生記憶體或記憶體。

建構函式

ReadOnlySpan<T>(T)	在指定的參考周圍建立長度為1的新 ReadOnlySpan<T>。
ReadOnlySpan<T>(T[])	在整個指定的陣列上建立新的 ReadOnlySpan<T>。
ReadOnlySpan<T>(T[], Int32, Int32)	建立新的 ReadOnlySpan<T>，其中包含從指定索引開始之陣列的指定項目數。
ReadOnlySpan<T>(Void*, Int32)	從指定記憶體位址開始的指定 T 項目數目，建立新的 ReadOnlySpan<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>)	使用指定的 IComparable<T> 泛型介面，搜尋整個已排序 ReadOnlySpan<T> 的值。
BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)	使用指定的 TComparer 泛型類型，搜尋整個已排序 ReadOnlySpan<T> 指定的值。
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)	使用指定的 TComparable 泛型類型，搜尋整個排序 ReadOnlySpan<T> 的值。
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>)	計算 span中發生 value 的次數。
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)	使用邏輯 OR 運算符搜尋任何指定值的第一個索引，類似於呼叫 IndexOf 多次。
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	使用邏輯 OR 運算符搜尋任何指定值的第一個索引，類似於呼叫 IndexOf 多次。
IndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	搜尋任何指定值的第一個索引。
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	使用邏輯 OR 運算符搜尋任何指定值的第一個索引，類似於呼叫 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>, 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)	使用邏輯 OR 運算符搜尋任何指定值的最後一個索引，類似於呼叫 LastIndexOf 數次。
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	使用邏輯 OR 運算符搜尋任何指定值的最後一個索引，類似於呼叫 LastIndexOf 數次。
LastIndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	搜尋任何指定值的最後一個索引。
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	使用邏輯 OR 運算符搜尋任何指定值的最後一個索引，類似於呼叫 LastIndexOf 數次。
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，並將所有出現的 oldValue 取代為 newValue。
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>)	從範圍中移除在唯讀範圍中指定的所有前置專案集。

另請參閱

• 記憶體和跨範圍相關類型
• 記憶體<T> 和 Span<T> 使用指導方針