Teilen über


Span<T> Struktur

Definition

Bietet eine typsichere und speichersichere Darstellung eines zusammenhängenden Bereichs mit beliebigem Arbeitsspeicher.

generic <typename T>
public value class Span
public readonly ref struct Span<T>
[System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.SpanMarshaller<,>))]
public readonly ref struct Span<T>
type Span<'T> = struct
[<System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.SpanMarshaller<,>))>]
type Span<'T> = struct
Public Structure Span(Of T)

Typparameter

T

Der Typ der Elemente in .Span<T>

Vererbung
Span<T>
Attribute

Hinweise

Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für Span<T>.

Konstruktoren

Span<T>(T)

Erstellt einen neuen Span<T> mit der Länge 1 um den angegebenen Verweis.

Span<T>(T[])

Erstellt ein neues Span<T>-Objekt über das gesamte angegebene Array.

Span<T>(T[], Int32, Int32)

Erstellt ein neues Span<T>-Objekt, das eine angegebene Anzahl von Elementen aus einem Array enthält. Dabei wird an einem angegebenen Index begonnen.

Span<T>(Void*, Int32)

Erstellt ein neues Span<T> -Objekt aus einer angegebenen Anzahl von T Elementen, beginnend bei einer angegebenen Speicheradresse.

Eigenschaften

Empty

Gibt ein leeres Span<T>-Objekt zurück.

IsEmpty

Gibt einen Wert zurück, der angibt, ob das aktuelle Span<T>-Element leer ist.

Item[Int32]

Ruft das Element am angegebenen nullbasierten Index ab.

Length

Gibt die Länge des aktuellen Span-Elements fest.

Methoden

Clear()

Löscht den Inhalt dieses Span<T>-Objekts.

CopyTo(Span<T>)

Kopiert die Inhalte dieses Span<T>-Elements in ein Span<T>-Zielelement.

Equals(Object)
Veraltet.
Veraltet.

Das Aufrufen dieser Methode wird nicht unterstützt.

Fill(T)

Füllt die Elemente dieses Span-Elements mit einem angegebenen Wert auf.

GetEnumerator()

Gibt einen Enumerator für dieses Span<T>-Element zurück.

GetHashCode()
Veraltet.

Löst eine NotSupportedException aus.

GetPinnableReference()

Gibt einen Verweis auf ein Objekt vom Typ T zurück, das zum Anheften verwendet werden kann.

Diese Methode dient zur Unterstützung von .NET-Compilern und ist nicht für den Aufruf durch Benutzercode vorgesehen.

Slice(Int32)

Bildet einen Slice aus dem aktuellen Span-Element, das an einem angegebenen Index beginnt.

Slice(Int32, Int32)

Bildet einen Slice aus dem aktuellen Span-Element. Dabei wird an einem angegebenen Index für eine angegebene Länge begonnen.

ToArray()

Kopiert die Inhalte dieses Span-Elements in ein neues Array.

ToString()

Gibt die Zeichenfolgendarstellung dieses Span<T>-Objekts zurück.

TryCopyTo(Span<T>)

Versucht, das aktuelle Span<T>-Element in ein Span<T>-Zielelement zu kopieren und gibt einen Wert zurück, der angibt, ob der Kopiervorgang erfolgreich war.

Operatoren

Equality(Span<T>, Span<T>)

Gibt einen Wert zurück, der angibt, ob zwei Span<T>-Objekte gleich sind.

Implicit(ArraySegment<T> to Span<T>)

Definiert eine implizite Konvertierung von ArraySegment<T> in Span<T>.

Implicit(Span<T> to ReadOnlySpan<T>)

Definiert eine implizite Konvertierung von Span<T> in ReadOnlySpan<T>.

Implicit(T[] to Span<T>)

Definiert eine implizite Konvertierung eines Arrays in Span<T>.

Inequality(Span<T>, Span<T>)

Gibt einen Wert zurück, der angibt, ob zwei Span<T>-Objekte ungleich sind.

Erweiterungsmethoden

ToImmutableArray<T>(Span<T>)

Konvertiert die Spanne in ein unveränderliches Array.

BinarySearch<T>(Span<T>, IComparable<T>)

Durchsucht ein ganzes sortiertes Span<T> mithilfe der angegebenen generischen IComparable<T>-Schnittstelle nach einem Wert.

BinarySearch<T,TComparer>(Span<T>, T, TComparer)

Durchsucht ein ganzes sortiertes Span<T> mithilfe des angegebenen generischen TComparer-Typs nach einem angegebenen Wert.

BinarySearch<T,TComparable>(Span<T>, TComparable)

Durchsucht ein ganzes sortiertes Span<T> mithilfe des angegebenen generischen TComparable-Typs nach einem Wert.

CommonPrefixLength<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach der Länge eines gemeinsamen Präfixes, das zwischen span und othergemeinsam verwendet wird.

CommonPrefixLength<T>(Span<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Sucht nach der Länge eines gemeinsamen Präfixes, das zwischen span und othergemeinsam verwendet wird.

Contains<T>(Span<T>, T)

Gibt an, ob ein angegebener Wert in einer Spanne gefunden wird. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.

ContainsAny<T>(Span<T>, T, T)

Sucht nach einem Vorkommen von value0 oder und value1gibt zurück true , wenn gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben false.

ContainsAny<T>(Span<T>, T, T, T)

Sucht nach einem Vorkommen von value0, value1oder value2, und gibt zurück true , wenn gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben false.

ContainsAny<T>(Span<T>, SearchValues<T>)

Sucht nach einem Vorkommen eines der angegebenen values und gibt zurück true , falls gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben false.

ContainsAny<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach einem Vorkommen eines der angegebenen values und gibt zurück true , falls gefunden. Wenn sie nicht gefunden wird, wird zurückgegeben false.

ContainsAnyExcept<T>(Span<T>, T)

Sucht nach einem anderen Wert als dem angegebenen value.

ContainsAnyExcept<T>(Span<T>, T, T)

Sucht nach einem anderen Wert als value0 oder value1.

ContainsAnyExcept<T>(Span<T>, T, T, T)

Sucht nach einem anderen Wert als value0, value1oder value2.

ContainsAnyExcept<T>(Span<T>, SearchValues<T>)

Sucht nach einem anderen Wert als dem angegebenen values.

ContainsAnyExcept<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach einem anderen Wert als dem angegebenen values.

ContainsAnyExceptInRange<T>(Span<T>, T, T)

Sucht nach einem Beliebigen Wert außerhalb des Bereichs zwischen lowInclusive und , highInclusiveinklusive.

ContainsAnyInRange<T>(Span<T>, T, T)

Sucht nach einem beliebigen Wert im Bereich zwischen lowInclusive und , highInclusiveinklusive, und gibt zurück true , wenn er gefunden wird. Wenn sie nicht gefunden wird, wird zurückgegeben false.

Count<T>(Span<T>, T)

Zählt, wie oft die angegebene value in der spanauftritt.

Count<T>(Span<T>, ReadOnlySpan<T>)

Zählt, wie oft die angegebene value in der spanauftritt.

EndsWith<T>(Span<T>, ReadOnlySpan<T>)

Bestimmt, ob die angegebene Sequenz am Ende einer Spanne angezeigt wird.

IndexOf<T>(Span<T>, T)

Sucht nach dem angegebenen Wert und gibt den Index des ersten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.

IndexOf<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach der angegebenen Sequenz und gibt den Index des ersten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.

IndexOfAny<T>(Span<T>, T, T)

Sucht nach dem ersten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von IndexOf mit dem logischen OR-Operator (ODER).

IndexOfAny<T>(Span<T>, T, T, T)

Sucht nach dem ersten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von IndexOf mit dem logischen OR-Operator (ODER).

IndexOfAny<T>(Span<T>, SearchValues<T>)

Sucht nach dem ersten Index eines der angegebenen Werte.

IndexOfAny<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach dem ersten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von IndexOf mit dem logischen OR-Operator (ODER).

IndexOfAnyExcept<T>(Span<T>, T)

Sucht nach dem ersten Index eines anderen Werts als dem angegebenen value.

IndexOfAnyExcept<T>(Span<T>, T, T)

Sucht nach dem ersten Index eines anderen Werts als dem angegebenen value0 oder value1.

IndexOfAnyExcept<T>(Span<T>, T, T, T)

Sucht nach dem ersten Index eines anderen Werts als dem angegebenen value0, value1oder value2.

IndexOfAnyExcept<T>(Span<T>, SearchValues<T>)

Sucht nach dem ersten Index eines anderen Werts als dem angegebenen values.

IndexOfAnyExcept<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach dem ersten Index eines anderen Werts als dem angegebenen values.

IndexOfAnyExceptInRange<T>(Span<T>, T, T)

Sucht nach dem ersten Index eines beliebigen Werts außerhalb des Bereichs zwischen lowInclusive und , highInclusiveeinschließlich.

IndexOfAnyInRange<T>(Span<T>, T, T)

Sucht nach dem ersten Index eines beliebigen Werts im Bereich zwischen lowInclusive und , highInclusiveeinschließlich.

LastIndexOf<T>(Span<T>, T)

Sucht nach dem angegebenen Wert und gibt den Index des letzten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.

LastIndexOf<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach der angegebenen Sequenz und gibt den Index des letzten Vorkommens zurück. Werte werden mit „IEquatable{T}.Equals(T)“ verglichen.

LastIndexOfAny<T>(Span<T>, T, T)

Sucht nach dem letzten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von LastIndexOf mit dem logischen OR-Operator (ODER).

LastIndexOfAny<T>(Span<T>, T, T, T)

Sucht nach dem letzten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von LastIndexOf mit dem logischen OR-Operator (ODER).

LastIndexOfAny<T>(Span<T>, SearchValues<T>)

Sucht nach dem letzten Index eines der angegebenen Werte.

LastIndexOfAny<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach dem letzten Index eines der angegebenen Werte, ähnlich dem mehrmaligen Aufruf von LastIndexOf mit dem logischen OR-Operator (ODER).

LastIndexOfAnyExcept<T>(Span<T>, T)

Sucht nach dem letzten Index eines anderen Werts als dem angegebenen value.

LastIndexOfAnyExcept<T>(Span<T>, T, T)

Sucht nach dem letzten Index eines anderen Werts als dem angegebenen value0 oder value1.

LastIndexOfAnyExcept<T>(Span<T>, T, T, T)

Sucht nach dem letzten Index eines anderen Werts als dem angegebenen value0, value1oder value2.

LastIndexOfAnyExcept<T>(Span<T>, SearchValues<T>)

Sucht nach dem letzten Index eines anderen Werts als dem angegebenen values.

LastIndexOfAnyExcept<T>(Span<T>, ReadOnlySpan<T>)

Sucht nach dem letzten Index eines anderen Werts als dem angegebenen values.

LastIndexOfAnyExceptInRange<T>(Span<T>, T, T)

Sucht nach dem letzten Index eines Beliebigen Werts außerhalb des Bereichs zwischen lowInclusive und , highInclusiveinklusive.

LastIndexOfAnyInRange<T>(Span<T>, T, T)

Sucht nach dem letzten Index eines beliebigen Werts im Bereich zwischen lowInclusive und , highInclusiveeinschließlich.

Overlaps<T>(Span<T>, ReadOnlySpan<T>)

Bestimmt, ob sich eine Spanne und eine schreibgeschützte Spanne im Speicher überlappen.

Overlaps<T>(Span<T>, ReadOnlySpan<T>, Int32)

Bestimmt, ob sich eine Spanne und eine schreibgeschützte Spanne im Speicher überlappen, und gibt den Elementoffset aus.

Replace<T>(Span<T>, T, T)

Diese Funktion ersetzt alle Vorkommen von oldValue durch newValue.

Reverse<T>(Span<T>)

Kehrt die Reihenfolge der Elemente in der gesamten Spanne um.

SequenceCompareTo<T>(Span<T>, ReadOnlySpan<T>)

Bestimmt die relative Reihenfolge von einer Spanne und einer schreibgeschützten Spanne durch Vergleichen der Elemente mit „IComparable{T}.CompareTo(T)“.

SequenceEqual<T>(Span<T>, ReadOnlySpan<T>)

Bestimmt, ob eine Spanne und eine schreibgeschützte Spanne identisch sind, indem die Elemente mit „IEquatable{T}.Equals(T)“ verglichen werden.

SequenceEqual<T>(Span<T>, ReadOnlySpan<T>, IEqualityComparer<T>)

Bestimmt, ob zwei Sequenzen gleich sind, indem die Elemente mit einem IEqualityComparer<T>verglichen werden.

Sort<T>(Span<T>)

Sortiert die Elemente im Gesamten Span<T> mithilfe der IComparable<T> Implementierung jedes Elements von Span<T>.

Sort<T>(Span<T>, Comparison<T>)

Sortiert die Elemente in der gesamten Span<T> mithilfe des angegebenen Comparison<T>.

Sort<T,TComparer>(Span<T>, TComparer)

Sortiert die Elemente innerhalb von Span<T> mithilfe von TComparer.

Sort<TKey,TValue>(Span<TKey>, Span<TValue>)

Sortiert ein Paar von Spannen (eine enthält die Schlüssel und die andere die entsprechenden Elemente) auf Basis der Schlüssel in der ersten Schnittstelle Span<T> und mithilfe der IComparable<T>-Implementierung der einzelnen Schlüssel.

Sort<TKey,TValue>(Span<TKey>, Span<TValue>, Comparison<TKey>)

Sortiert ein Paar von Spannen (eine enthält die Schlüssel und die andere die entsprechenden Elemente) auf Basis der Schlüssel in der ersten Schnittstelle Span<T> und mithilfe des angegebenen Vergleichs.

Sort<TKey,TValue,TComparer>(Span<TKey>, Span<TValue>, TComparer)

Sortiert ein Paar von Spannen (eine enthält die Schlüssel und die andere die entsprechenden Elemente) auf Basis der Schlüssel in der ersten Schnittstelle Span<T> und mithilfe der angegebenen Vergleichsfunktion.

StartsWith<T>(Span<T>, ReadOnlySpan<T>)

Bestimmt, ob eine angegebene Sequenz am Anfang einer Spanne angezeigt wird.

Trim<T>(Span<T>, T)

Entfernt alle führenden und nachfolgenden Vorkommen eines angegebenen Elements aus einer Spanne.

Trim<T>(Span<T>, ReadOnlySpan<T>)

Entfernt alle führenden und nachfolgenden Vorkommen einer Reihe von Elementen, die in einer schreibgeschützten Spanne angegeben sind, aus einer Spanne.

TrimEnd<T>(Span<T>, T)

Entfernt alle nachfolgenden Vorkommen eines angegebenen Elements aus einer Spanne.

TrimEnd<T>(Span<T>, ReadOnlySpan<T>)

Entfernt alle nachfolgenden Vorkommen einer Reihe von Elementen, die in einer schreibgeschützten Spanne angegeben sind, aus einer Spanne.

TrimStart<T>(Span<T>, T)

Entfernt alle führenden Vorkommen eines bestimmten Elements aus der Spanne.

TrimStart<T>(Span<T>, ReadOnlySpan<T>)

Entfernt alle führenden Vorkommen einer Reihe von Elementen, die in einer schreibgeschützten Spanne angegeben sind, aus der Spanne.

Gilt für:

Weitere Informationen