ReadOnlySpan<T> 结构

定义

命名空间:

System

程序集:

System.Runtime.dll

Source:

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 结构，永远无法转义到托管堆。 Ref 结构类型具有许多限制，以确保无法将其提升到托管堆，包括无法装箱、在 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} 比较值。等于（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} 比较值。等于（T）。
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	搜索指定的序列并返回其第一个匹配项的索引。 使用 IEquatable{T} 比较值。等于（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} 比较值。等于（T）。
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	搜索指定的序列并返回其最后一个匹配项的索引。 使用 IEquatable{T} 比较值。等于（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} 比较元素，确定两个只读序列是否相等。等于（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> 和跨度<T> 使用指南