Span<T> Structure

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Source:: Span.cs

Source:: Span.cs

Source:: Span.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit une représentation de type sécurisé et de mémoire sécurisée d’une région contiguë de mémoire arbitraire.

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)

Paramètres de type

T

Type d’éléments dans .Span<T>

Héritage: Object

ValueType
Span<T>

Attributs: NativeMarshallingAttribute

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour l’étendue<T>.

Constructeurs

Span<T>(T)	Crée un nouveau Span<T> de longueur 1 autour de la référence spécifiée.
Span<T>(T[])	Crée un objet Span<T> sur l’intégralité d’un tableau spécifié.
Span<T>(T[], Int32, Int32)	Crée un objet Span<T> qui inclut un nombre spécifié d’élément à partir d’un tableau commençant à l’index spécifié.
Span<T>(Void*, Int32)	Crée un Span<T> objet à partir d’un nombre spécifié d’éléments `T` commençant à une adresse mémoire spécifiée.

Propriétés

Empty	Retourne un objet Span<T> vide.
IsEmpty	Retourne une valeur qui indique si le Span<T> actuel est vide.
Item[Int32]	Obtient l’élément au niveau de l’index de base zéro spécifié.
Length	Retourne la longueur de l’étendue actuelle.

Méthodes

Clear()	Efface le contenu de cet objet Span<T>.
CopyTo(Span<T>)	Copie le contenu de ce Span<T> dans un Span<T> de destination.
Equals(Object)	Obsolète. Obsolète. Les appels à cette méthode ne sont pas pris en charge.
Fill(T)	Remplit les éléments de cette étendue avec une valeur spécifiée.
GetEnumerator()	Retourne un énumérateur pour ce Span<T>.
GetHashCode()	Obsolète. Lève un NotSupportedException.
GetPinnableReference()	Retourne une référence à un objet de type T qui peut être utilisée pour l’épinglage. Cette méthode est destinée à prendre en charge les compilateurs .NET et n’est pas destinée à être appelée par le code utilisateur.
Slice(Int32)	Constitue une section en dehors de l’étendue actuelle qui commence à l’index spécifié.
Slice(Int32, Int32)	Constitue une section en dehors de l’étendue actuelle qui commence à un index spécifié pour une longueur spécifiée.
ToArray()	Copie le contenu de cette étendue dans un nouveau tableau.
ToString()	Retourne la représentation sous forme de chaîne de cet objet Span<T>.
TryCopyTo(Span<T>)	Tente de copier le Span<T> actuel vers un Span<T> de destination et retourne une valeur qui indique si l’opération de copie a réussi.

Opérateurs

Equality(Span<T>, Span<T>)	Retourne une valeur qui indique si deux objets Span<T> sont égaux.
Implicit(ArraySegment<T> to Span<T>)	Définit une conversion implicite d’un ArraySegment<T> en Span<T>.
Implicit(Span<T> to ReadOnlySpan<T>)	Définit une conversion implicite d’un Span<T> en ReadOnlySpan<T>.
Implicit(T[] to Span<T>)	Définit une conversion implicite d’un tableau en Span<T>.
Inequality(Span<T>, Span<T>)	Retourne une valeur qui indique si deux objets Span<T> ne sont pas égaux.

Méthodes d’extension

ToImmutableArray<T>(Span<T>)	Convertit l’étendue en tableau immuable.
BinarySearch<T>(Span<T>, IComparable<T>)	Recherche une valeur dans une Span<T> entière triée en utilisant l’interface générique IComparable<T> spécifiée.
BinarySearch<T,TComparer>(Span<T>, T, TComparer)	Recherche une valeur spécifiée dans une Span<T> entière triée en utilisant le type générique `TComparer` spécifié.
BinarySearch<T,TComparable>(Span<T>, TComparable)	Recherche une valeur dans une Span<T> entière triée en utilisant le type générique `TComparable` spécifié.
CommonPrefixLength<T>(Span<T>, ReadOnlySpan<T>)	Recherche la longueur de tout préfixe commun partagé entre `span` et `other`.
CommonPrefixLength<T>(Span<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Recherche la longueur de tout préfixe commun partagé entre `span` et `other`.
Contains<T>(Span<T>, T)	Indique si une valeur spécifiée est trouvée dans une étendue. Les valeurs sont comparées en utilisant IEquatable{T}.Equals(T).
ContainsAny<T>(Span<T>, T, T)	Recherche une occurrence de `value0` ou `value1`, et retourne `true` si elle est trouvée. S’il est introuvable, retourne `false`.
ContainsAny<T>(Span<T>, T, T, T)	Recherche une occurrence de `value0`, `value1`ou `value2`, et retourne `true` si elle est trouvée. S’il est introuvable, retourne `false`.
ContainsAny<T>(Span<T>, SearchValues<T>)	Recherche une occurrence de l’un des spécifiés `values` et retourne `true` si elle est trouvée. S’il est introuvable, retourne `false`.
ContainsAny<T>(Span<T>, ReadOnlySpan<T>)	Recherche une occurrence de l’un des spécifiés `values` et retourne `true` si elle est trouvée. S’il est introuvable, retourne `false`.
ContainsAnyExcept<T>(Span<T>, T)	Recherche toute valeur autre que le spécifié `value`.
ContainsAnyExcept<T>(Span<T>, T, T)	Recherche toute valeur autre que `value0` ou `value1`.
ContainsAnyExcept<T>(Span<T>, T, T, T)	Recherche toute valeur autre que `value0`, `value1`ou `value2`.
ContainsAnyExcept<T>(Span<T>, SearchValues<T>)	Recherche toute valeur autre que le spécifié `values`.
ContainsAnyExcept<T>(Span<T>, ReadOnlySpan<T>)	Recherche toute valeur autre que le spécifié `values`.
ContainsAnyExceptInRange<T>(Span<T>, T, T)	Recherche toute valeur en dehors de la plage comprise entre `lowInclusive` et `highInclusive`, inclusive.
ContainsAnyInRange<T>(Span<T>, T, T)	Recherche n’importe quelle valeur dans la plage comprise entre `lowInclusive` et `highInclusive`, inclusive, et retourne `true` si elle est trouvée. S’il est introuvable, retourne `false`.
Count<T>(Span<T>, T)	Compte le nombre de fois que le spécifié `value` se produit dans le `span`.
Count<T>(Span<T>, ReadOnlySpan<T>)	Compte le nombre de fois que le spécifié `value` se produit dans le `span`.
EndsWith<T>(Span<T>, ReadOnlySpan<T>)	Détermine si la séquence spécifiée apparaît à la fin d’une étendue.
IndexOf<T>(Span<T>, T)	Recherche la valeur spécifiée et retourne l’index de sa première occurrence. Les valeurs sont comparées en utilisant IEquatable{T}.Equals(T).
IndexOf<T>(Span<T>, ReadOnlySpan<T>)	Recherche la séquence spécifiée et retourne l’index de sa première occurrence. Les valeurs sont comparées en utilisant IEquatable{T}.Equals(T).
IndexOfAny<T>(Span<T>, T, T)	Recherche le premier index de l’une des valeurs spécifiées similaires à l’appel d’IndexOf plusieurs fois avec l’opérateur OR logique.
IndexOfAny<T>(Span<T>, T, T, T)	Recherche le premier index de l’une des valeurs spécifiées similaires à l’appel d’IndexOf plusieurs fois avec l’opérateur OR logique.
IndexOfAny<T>(Span<T>, SearchValues<T>)	Recherche le premier index de l’une des valeurs spécifiées.
IndexOfAny<T>(Span<T>, ReadOnlySpan<T>)	Recherche le premier index de l’une des valeurs spécifiées similaires à l’appel d’IndexOf plusieurs fois avec l’opérateur OR logique.
IndexOfAnyExcept<T>(Span<T>, T)	Recherche le premier index d’une valeur autre que le spécifié `value`.
IndexOfAnyExcept<T>(Span<T>, T, T)	Recherche le premier index d’une valeur autre que le spécifié `value0` ou `value1`.
IndexOfAnyExcept<T>(Span<T>, T, T, T)	Recherche le premier index d’une valeur autre que le `value0`spécifié , `value1`ou `value2`.
IndexOfAnyExcept<T>(Span<T>, SearchValues<T>)	Recherche le premier index d’une valeur autre que le spécifié `values`.
IndexOfAnyExcept<T>(Span<T>, ReadOnlySpan<T>)	Recherche le premier index d’une valeur autre que le spécifié `values`.
IndexOfAnyExceptInRange<T>(Span<T>, T, T)	Recherche le premier index d’une valeur en dehors de la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
IndexOfAnyInRange<T>(Span<T>, T, T)	Recherche le premier index d’une valeur dans la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
LastIndexOf<T>(Span<T>, T)	Recherche la valeur spécifiée et retourne l’index de sa dernière occurrence. Les valeurs sont comparées en utilisant IEquatable{T}.Equals(T).
LastIndexOf<T>(Span<T>, ReadOnlySpan<T>)	Recherche la séquence spécifiée et retourne l’index de sa dernière occurrence. Les valeurs sont comparées en utilisant IEquatable{T}.Equals(T).
LastIndexOfAny<T>(Span<T>, T, T)	Recherche le dernier index de l’une des valeurs spécifiées similaires à l’appel de LastIndexOf plusieurs fois avec l’opérateur OR logique.
LastIndexOfAny<T>(Span<T>, T, T, T)	Recherche le dernier index de l’une des valeurs spécifiées similaires à l’appel de LastIndexOf plusieurs fois avec l’opérateur OR logique.
LastIndexOfAny<T>(Span<T>, SearchValues<T>)	Recherche le dernier index de l’une des valeurs spécifiées.
LastIndexOfAny<T>(Span<T>, ReadOnlySpan<T>)	Recherche le dernier index de l’une des valeurs spécifiées similaires à l’appel de LastIndexOf plusieurs fois avec l’opérateur OR logique.
LastIndexOfAnyExcept<T>(Span<T>, T)	Recherche le dernier index de toute valeur autre que le spécifié `value`.
LastIndexOfAnyExcept<T>(Span<T>, T, T)	Recherche le dernier index d’une valeur autre que le spécifié `value0` ou `value1`.
LastIndexOfAnyExcept<T>(Span<T>, T, T, T)	Recherche le dernier index d’une valeur autre que le spécifié `value0`, `value1`ou `value2`.
LastIndexOfAnyExcept<T>(Span<T>, SearchValues<T>)	Recherche le dernier index de toute valeur autre que le spécifié `values`.
LastIndexOfAnyExcept<T>(Span<T>, ReadOnlySpan<T>)	Recherche le dernier index de toute valeur autre que le spécifié `values`.
LastIndexOfAnyExceptInRange<T>(Span<T>, T, T)	Recherche le dernier index d’une valeur en dehors de la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
LastIndexOfAnyInRange<T>(Span<T>, T, T)	Recherche le dernier index d’une valeur dans la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
Overlaps<T>(Span<T>, ReadOnlySpan<T>)	Détermine si une étendue et une étendue en lecture seule se chevauchent dans la mémoire.
Overlaps<T>(Span<T>, ReadOnlySpan<T>, Int32)	Détermine si une étendue et une étendue en lecture seule se chevauchent dans la mémoire et génère le décalage des éléments.
Replace<T>(Span<T>, T, T)	Remplace toutes les occurrences de `oldValue` par `newValue`.
Reverse<T>(Span<T>)	Inverse la séquence des éléments dans l’intégralité de l’étendue.
SequenceCompareTo<T>(Span<T>, ReadOnlySpan<T>)	Détermine l’ordre relatif d’une étendue et d’une étendue en lecture seule en comparant les éléments avec IComparable{T}.CompareTo(T).
SequenceEqual<T>(Span<T>, ReadOnlySpan<T>)	Détermine si une étendue et une étendue en lecture seule sont égales en comparant les éléments avec IEquatable{T}.Equals(T).
SequenceEqual<T>(Span<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Détermine si deux séquences sont égales en comparant les éléments à l’aide d’un IEqualityComparer<T>.
Sort<T>(Span<T>)	Trie les éléments dans l’ensemble Span<T> à l’aide de l’implémentation IComparable<T> de chaque élément du Span<T>.
Sort<T>(Span<T>, Comparison<T>)	Trie les éléments dans l'ensemble de Span<T> à l'aide du Comparison<T> spécifié.
Sort<T,TComparer>(Span<T>, TComparer)	Trie les éléments dans l’ensemble de Span<T> à l’aide de `TComparer`.
Sort<TKey,TValue>(Span<TKey>, Span<TValue>)	Trie une paire d’étendues (l’une contenant les clés et l’autre contenant les éléments correspondants) en fonction des clés du premier Span<T> à l’aide de l’implémentation IComparable<T>de chaque clé.
Sort<TKey,TValue>(Span<TKey>, Span<TValue>, Comparison<TKey>)	Trie une paire d’étendues (l’une contenant les clés et l’autre contenant les éléments correspondants) en fonction des clés de la première Span<T> à l’aide de la comparaison spécifiée.
Sort<TKey,TValue,TComparer>(Span<TKey>, Span<TValue>, TComparer)	Trie une paire d’étendues (l’une contenant les clés et l’autre contenant les éléments correspondants) en fonction des clés de la première Span<T> à l’aide du comparateur spécifié.
StartsWith<T>(Span<T>, ReadOnlySpan<T>)	Détermine si une séquence spécifiée apparaît au début d’une étendue.
Trim<T>(Span<T>, T)	Supprime d’une étendue toutes les occurrences de début et de fin d’un élément spécifié.
Trim<T>(Span<T>, ReadOnlySpan<T>)	Supprime d’une étendue toutes les occurrences de début et de fin d’un jeu d’éléments spécifié dans une étendue en lecture seule.
TrimEnd<T>(Span<T>, T)	Supprime d’une étendue toutes les occurrences de fin d’un élément spécifié.
TrimEnd<T>(Span<T>, ReadOnlySpan<T>)	Supprime d’une étendue toutes les occurrences de fin d’un jeu d’éléments spécifié dans une étendue en lecture seule.
TrimStart<T>(Span<T>, T)	Supprime de l’étendue toutes les occurrences de début d’un élément spécifié.
TrimStart<T>(Span<T>, ReadOnlySpan<T>)	Supprime d’une étendue toutes les occurrences de début d’un jeu d’éléments spécifié dans une étendue en lecture seule.

S’applique à