ReadOnlySpan<T> Struktur

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

ReadOnlySpan.cs

Menyediakan representasi baca-saja yang aman untuk jenis dan memori dari wilayah memori arbitrer yang berdekatan.

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)

Jenis parameter

T

Jenis item dalam ReadOnlySpan<T>.

Warisan

Object

ValueType

ReadOnlySpan<T>

Atribut

NativeMarshallingAttribute

Keterangan

adalah struct ref yang dialokasikan pada tumpukan dan tidak pernah dapat melarikan diri ke tumpukan terkelola. Jenis struct Ref memiliki sejumlah batasan untuk memastikan bahwa mereka tidak dapat dipromosikan ke tumpukan terkelola, termasuk bahwa mereka tidak dapat dikotak, diambil dalam ekspresi lambda, ditetapkan ke variabel jenis Object, ditetapkan ke variabel dynamic, dan mereka tidak dapat menerapkan jenis antarmuka apa pun.

Instans ReadOnlySpan<T> sering digunakan untuk mereferensikan elemen array atau sebagian array. Namun, tidak seperti array, instans ReadOnlySpan<T> dapat menunjuk ke memori terkelola, memori asli, atau memori yang dikelola pada tumpukan.

Konstruktor

ReadOnlySpan<T>(T)	Membuat ReadOnlySpan<T> baru dengan panjang 1 di sekitar referensi yang ditentukan.
ReadOnlySpan<T>(T[])	Membuat ReadOnlySpan<T> baru di atas keseluruhan array tertentu.
ReadOnlySpan<T>(T[], Int32, Int32)	Membuat ReadOnlySpan<T> baru yang menyertakan sejumlah elemen array tertentu yang dimulai pada indeks tertentu.
ReadOnlySpan<T>(Void*, Int32)	Membuat ReadOnlySpan<T> baru dari sejumlah elemen T tertentu yang dimulai pada alamat memori tertentu.

Properti

Empty	Mengembalikan ReadOnlySpan<T>kosong.
IsEmpty	Mengembalikan nilai yang menunjukkan rentang baca-saja saat ini kosong.
Item[Int32]	Mendapatkan item dari rentang baca-saja pada indeks berbasis nol yang ditentukan.
Length	Jumlah item dalam rentang baca-saja.

Metode

CopyTo(Span<T>)	Menyalin konten ReadOnlySpan<T> ini ke dalam Span<T>tujuan .
Equals(Object)	Kedaluwarsa. Tidak didukung. Melemparkan NotSupportedException.
GetEnumerator()	Mengembalikan enumerator untuk ReadOnlySpan<T>ini.
GetHashCode()	Kedaluwarsa. Tidak didukung. Melemparkan NotSupportedException.
GetPinnableReference()	Mengembalikan referensi baca-saja ke objek jenis T yang dapat digunakan untuk penyematan. Metode ini dimaksudkan untuk mendukung pengkompilasi .NET dan tidak dimaksudkan untuk dipanggil oleh kode pengguna.
Slice(Int32)	Membentuk ikatan dari rentang baca-saja saat ini yang dimulai pada indeks tertentu.
Slice(Int32, Int32)	Membentuk ikatan dari rentang baca-saja saat ini yang dimulai pada indeks tertentu untuk panjang yang ditentukan.
ToArray()	Menyalin isi rentang baca-saja ini ke dalam array baru.
ToString()	Mengembalikan representasi string dari ReadOnlySpan<T>ini.
TryCopyTo(Span<T>)	Mencoba menyalin konten ReadOnlySpan<T> ini ke dalam Span<T> dan mengembalikan nilai untuk menunjukkan apakah operasi berhasil atau tidak.

Operator

Equality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mengembalikan nilai yang menunjukkan apakah dua instans ReadOnlySpan<T> sama.
Implicit(ArraySegment<T> to ReadOnlySpan<T>)	Menentukan konversi implisit dari ArraySegment<T> ke ReadOnlySpan<T>.
Implicit(T[] to ReadOnlySpan<T>)	Menentukan konversi implisit array ke ReadOnlySpan<T>.
Inequality(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mengembalikan nilai yang menunjukkan apakah dua instans ReadOnlySpan<T> tidak sama.

Metode Ekstensi

ToImmutableArray<T>(ReadOnlySpan<T>)	Menghasilkan array konten yang tidak dapat diubah dari elemen tertentu.
BinarySearch<T>(ReadOnlySpan<T>, IComparable<T>)	Mencari seluruh ReadOnlySpan<T> yang diurutkan untuk nilai menggunakan antarmuka generik IComparable<T> yang ditentukan.
BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)	Mencari seluruh ReadOnlySpan<T> yang diurutkan untuk nilai tertentu menggunakan jenis generik TComparer yang ditentukan.
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)	Mencari seluruh ReadOnlySpan<T> yang diurutkan untuk nilai menggunakan jenis generik TComparable yang ditentukan.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menemukan panjang awalan umum yang dibagikan antara span dan other.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Menentukan panjang awalan umum yang dibagikan antara span dan other.
Contains<T>(ReadOnlySpan<T>, T)	Menunjukkan apakah nilai yang ditentukan ditemukan dalam rentang baca-saja. Nilai dibandingkan menggunakan IEquatable{T}. Sama dengan(T).
ContainsAny<T>(ReadOnlySpan<T>, T, T)	Mencari kemunculan value0 atau value1.
ContainsAny<T>(ReadOnlySpan<T>, T, T, T)	Mencari kemunculan value0, value1, atau value2.
ContainsAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Mencari kemunculan salah satu valuesyang ditentukan .
ContainsAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari kemunculan salah satu valuesyang ditentukan .
ContainsAnyExcept<T>(ReadOnlySpan<T>, T)	Mencari nilai apa pun selain valueyang ditentukan .
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T)	Mencari nilai apa pun selain value0 atau value1.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Mencari nilai apa pun selain value0, value1, atau value2.
ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Mencari nilai apa pun selain valuesyang ditentukan .
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari nilai apa pun selain valuesyang ditentukan .
ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Mencari nilai apa pun di luar rentang antara lowInclusive dan highInclusive, inklusif.
ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T)	Mencari nilai apa pun dalam rentang antara lowInclusive dan highInclusive, inklusif.
Count<T>(ReadOnlySpan<T>, T)	Menghitung berapa kali value yang ditentukan terjadi di span.
Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menghitung berapa kali value terjadi di span.
EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menentukan apakah urutan yang ditentukan muncul di akhir rentang baca-saja.
IndexOf<T>(ReadOnlySpan<T>, T)	Mencari nilai yang ditentukan dan mengembalikan indeks kemunculan pertamanya. Nilai dibandingkan menggunakan IEquatable{T}. Sama dengan(T).
IndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari urutan yang ditentukan dan mengembalikan indeks kemunculan pertamanya. Nilai dibandingkan menggunakan IEquatable{T}. Sama dengan(T).
IndexOfAny<T>(ReadOnlySpan<T>, T, T)	Mencari indeks pertama dari salah satu nilai yang ditentukan yang mirip dengan memanggil IndexOf beberapa kali dengan operator OR logis.
IndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Mencari indeks pertama dari salah satu nilai yang ditentukan yang mirip dengan memanggil IndexOf beberapa kali dengan operator OR logis.
IndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Mencari indeks pertama dari salah satu nilai yang ditentukan.
IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari indeks pertama dari salah satu nilai yang ditentukan yang mirip dengan memanggil IndexOf beberapa kali dengan operator OR logis.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Mencari indeks pertama dari nilai apa pun selain valueyang ditentukan .
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Mencari indeks pertama dari nilai apa pun selain value0 atau value1yang ditentukan.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Mencari indeks pertama dari nilai apa pun selain value0yang ditentukan, value1, atau value2.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Mencari indeks pertama dari nilai apa pun selain valuesyang ditentukan .
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari indeks pertama dari nilai apa pun selain valuesyang ditentukan .
IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Mencari indeks pertama dari nilai apa pun di luar rentang antara lowInclusive dan highInclusive, inklusif.
IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Mencari indeks pertama dari nilai apa pun dalam rentang antara lowInclusive dan highInclusive, inklusif.
LastIndexOf<T>(ReadOnlySpan<T>, T)	Mencari nilai yang ditentukan dan mengembalikan indeks kemunculan terakhirnya. Nilai dibandingkan menggunakan IEquatable{T}. Sama dengan(T).
LastIndexOf<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari urutan yang ditentukan dan mengembalikan indeks kemunculan terakhirnya. Nilai dibandingkan menggunakan IEquatable{T}. Sama dengan(T).
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T)	Mencari indeks terakhir dari salah satu nilai yang ditentukan yang mirip dengan memanggil LastIndexOf beberapa kali dengan operator OR logis.
LastIndexOfAny<T>(ReadOnlySpan<T>, T, T, T)	Mencari indeks terakhir dari salah satu nilai yang ditentukan yang mirip dengan memanggil LastIndexOf beberapa kali dengan operator OR logis.
LastIndexOfAny<T>(ReadOnlySpan<T>, SearchValues<T>)	Mencari indeks terakhir dari salah satu nilai yang ditentukan.
LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari indeks terakhir dari salah satu nilai yang ditentukan yang mirip dengan memanggil LastIndexOf beberapa kali dengan operator OR logis.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T)	Mencari indeks terakhir dari nilai apa pun selain valueyang ditentukan .
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Mencari indeks terakhir dari nilai apa pun selain value0 atau value1yang ditentukan.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Mencari indeks terakhir dari nilai apa pun selain value0yang ditentukan, value1, atau value2.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Mencari indeks terakhir dari nilai apa pun selain valuesyang ditentukan .
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Mencari indeks terakhir dari nilai apa pun selain valuesyang ditentukan .
LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Mencari indeks terakhir dari nilai apa pun di luar rentang antara lowInclusive dan highInclusive, inklusif.
LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Mencari indeks terakhir dari nilai apa pun dalam rentang antara lowInclusive dan highInclusive, inklusif.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menentukan apakah dua urutan baca-saja tumpang tindih dalam memori.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, Int32)	Menentukan apakah dua urutan baca-saja tumpang tindih dalam memori dan menghasilkan offset elemen.
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T)	Salin source ke destination, menggantikan semua kemunculan oldValue dengan newValue.
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menentukan urutan relatif dari dua urutan baca-saja dengan membandingkan elemennya menggunakan IComparable{T}. CompareTo(T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menentukan apakah dua urutan baca-saja sama dengan membandingkan elemen menggunakan IEquatable{T}. Sama dengan(T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Menentukan apakah dua urutan sama dengan membandingkan elemen menggunakan IEqualityComparer<T>.
StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menentukan apakah urutan yang ditentukan muncul pada awal rentang baca-saja.
Trim<T>(ReadOnlySpan<T>, T)	Menghapus semua kemunculan awal dan akhir dari elemen tertentu dari rentang baca-saja.
Trim<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menghapus semua kemunculan awal dan akhir dari sekumpulan elemen yang ditentukan dalam rentang baca-saja dari rentang baca-saja.
TrimEnd<T>(ReadOnlySpan<T>, T)	Menghapus semua kemunculan berikutnya dari elemen tertentu dari rentang baca-saja.
TrimEnd<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menghapus semua kemunculan berikutnya dari sekumpulan elemen yang ditentukan dalam rentang baca-saja dari rentang baca-saja.
TrimStart<T>(ReadOnlySpan<T>, T)	Menghapus semua kemunculan awal elemen tertentu dari rentang.
TrimStart<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Menghapus semua kemunculan awal dari sekumpulan elemen yang ditentukan dalam rentang baca-saja dari rentang.

Lihat juga

• Jenis terkait memori dan rentang
• > Memori<T dan panduan penggunaan> Span<T