ReadOnlySpan<T> Structure

Référence

Définition

Espace de noms:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

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 et de mémoire sécurisés en lecture seule d’une zone contiguë de mémoire arbitraire.

generic <typename T>
public value class ReadOnlySpan

public readonly ref struct ReadOnlySpan<T>

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

type ReadOnlySpan<'T> = struct

[<System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))>]
type ReadOnlySpan<'T> = struct

Public Structure ReadOnlySpan(Of T)

Paramètres de type

T

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

Héritage: Object

ValueType
ReadOnlySpan<T>

Attributs: NativeMarshallingAttribute

Remarques

ReadOnlySpan<T> est un struct ref qui est alloué sur la pile et qui ne peut jamais échapper au tas managé. Les types ref struct ont un certain nombre de restrictions pour s’assurer qu’ils ne peuvent pas être promus dans le tas managé, notamment qu’ils ne peuvent pas être boxés, capturés dans des expressions lambda, affectés à des variables de type Object, affectés à dynamic des variables et qu’ils ne peuvent pas implémenter un type d’interface.

Une ReadOnlySpan<T> instance est souvent utilisée pour référencer les éléments d’un tableau ou d’une partie d’un tableau. Contrairement à un tableau, toutefois, un ReadOnlySpan<T> instance peut pointer vers la mémoire managée, la mémoire native ou la mémoire gérée sur la pile.

Constructeurs

ReadOnlySpan<T>(T)	Crée un nouveau ReadOnlySpan<T> de longueur 1 autour de la référence spécifiée.
ReadOnlySpan<T>(T[])	Crée un ReadOnlySpan<T> sur l’intégralité d’un tableau spécifié.
ReadOnlySpan<T>(T[], Int32, Int32)	Crée un ReadOnlySpan<T> qui inclut un nombre spécifié d’élément à partir d’un tableau commençant à l’index spécifié.
ReadOnlySpan<T>(Void*, Int32)	Crée un ReadOnlySpan<T> à 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 ReadOnlySpan<T> vide.
IsEmpty	Retourne une valeur qui indique que l’étendue en lecture seule actuelle est vide.
Item[Int32]	Obtient un élément de l’étendue en lecture seule à l’index de base zéro spécifié.
Length	Nombre d’éléments dans l’étendue en lecture seule.

Méthodes

CopyTo(Span<T>)	Copie le contenu de ce ReadOnlySpan<T> dans un Span<T> de destination.
Equals(Object)	Obsolète. Obsolète. Non pris en charge. Lève un NotSupportedException.
GetEnumerator()	Retourne un énumérateur pour ce ReadOnlySpan<T>.
GetHashCode()	Obsolète. Non pris en charge. Lève un NotSupportedException.
GetPinnableReference()	Retourne une référence en lecture seule à un objet de type T qui peut être utilisé 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 en lecture seule actuelle qui commence à l’index spécifié.
Slice(Int32, Int32)	Constitue une section en dehors de l’étendue en lecture seule actuelle qui commence à un index spécifié pour une longueur spécifiée.
ToArray()	Copie le contenu de cette étendue en lecture seule dans un nouveau tableau.
ToString()	Retourne la représentation sous forme de chaîne de ReadOnlySpan<T>.
TryCopyTo(Span<T>)	Tente de copier le contenu de ce ReadOnlySpan<T> dans un Span<T> et retourne une valeur pour indiquer si l’opération a réussi.

Opérateurs

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

Méthodes d’extension

ToImmutableArray<T>(ReadOnlySpan<T>)	Produire un tableau immuable de contenu à partir d’éléments spécifiés.
BinarySearch<T>(ReadOnlySpan<T>, IComparable<T>)	Recherche une valeur dans une ReadOnlySpan<T> entière triée en utilisant l’interface générique IComparable<T> spécifiée.
BinarySearch<T,TComparer>(ReadOnlySpan<T>, T, TComparer)	Recherche une valeur spécifiée dans une ReadOnlySpan<T> entière triée en utilisant le type générique `TComparer` spécifié.
BinarySearch<T,TComparable>(ReadOnlySpan<T>, TComparable)	Recherche une valeur dans une ReadOnlySpan<T> entière triée en utilisant le type générique `TComparable` spécifié.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Recherche la longueur de tout préfixe commun partagé entre `span` et `other`.
CommonPrefixLength<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Détermine la longueur de tout préfixe commun partagé entre `span` et `other`.
Contains<T>(ReadOnlySpan<T>, T)	Indique si une valeur spécifiée est trouvée dans une étendue en lecture seule. Les valeurs sont comparées en utilisant IEquatable{T}.Equals(T).
ContainsAny<T>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<T>, T)	Recherche toute valeur autre que le spécifié `value`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T)	Recherche toute valeur autre que `value0` ou `value1`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Recherche toute valeur autre que `value0`, `value1`ou `value2`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Recherche toute valeur autre que le spécifié `values`.
ContainsAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Recherche toute valeur autre que le spécifié `values`.
ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Recherche toute valeur en dehors de la plage comprise entre `lowInclusive` et `highInclusive`, inclusive.
ContainsAnyInRange<T>(ReadOnlySpan<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>(ReadOnlySpan<T>, T)	Compte le nombre de fois que le spécifié `value` se produit dans le `span`.
Count<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Compte le nombre de fois où `value` se produit dans `span`.
EndsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Détermine si la séquence spécifiée apparaît à la fin d’une étendue en lecture seule.
IndexOf<T>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<T>, SearchValues<T>)	Recherche le premier index de l’une des valeurs spécifiées.
IndexOfAny<T>(ReadOnlySpan<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>(ReadOnlySpan<T>, T)	Recherche le premier index d’une valeur autre que le spécifié `value`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Recherche le premier index d’une valeur autre que le spécifié `value0` ou `value1`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Recherche le premier index d’une valeur autre que le `value0`spécifié , `value1`ou `value2`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Recherche le premier index d’une valeur autre que le spécifié `values`.
IndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Recherche le premier index d’une valeur autre que le spécifié `values`.
IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Recherche le premier index d’une valeur en dehors de la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Recherche le premier index d’une valeur dans la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
LastIndexOf<T>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<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>(ReadOnlySpan<T>, SearchValues<T>)	Recherche le dernier index de l’une des valeurs spécifiées.
LastIndexOfAny<T>(ReadOnlySpan<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>(ReadOnlySpan<T>, T)	Recherche le dernier index de toute valeur autre que le spécifié `value`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T)	Recherche le dernier index d’une valeur autre que le spécifié `value0` ou `value1`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, T, T, T)	Recherche le dernier index d’une valeur autre que le spécifié `value0`, `value1`ou `value2`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, SearchValues<T>)	Recherche le dernier index de toute valeur autre que le spécifié `values`.
LastIndexOfAnyExcept<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Recherche le dernier index de toute valeur autre que le spécifié `values`.
LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)	Recherche le dernier index d’une valeur en dehors de la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)	Recherche le dernier index d’une valeur dans la plage comprise entre `lowInclusive` et `highInclusive`, inclus.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Détermine si deux séquences en lecture seule se chevauchent dans la mémoire.
Overlaps<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, Int32)	Détermine si deux séquences en lecture seule se chevauchent dans la mémoire et génère le décalage des éléments.
Replace<T>(ReadOnlySpan<T>, Span<T>, T, T)	Copie `source` dans `destination`, en remplaçant toutes les occurrences de par `oldValuenewValue`.
SequenceCompareTo<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Détermine l’ordre relatif de deux séquences en lecture seule en comparant leurs éléments avec IComparable{T}.CompareTo(T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Détermine si deux séquences en lecture seule sont égales en comparant les éléments avec IEquatable{T}.Equals(T).
SequenceEqual<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<T>)	Détermine si deux séquences sont égales en comparant les éléments à l’aide d’un IEqualityComparer<T>.
StartsWith<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Détermine si une séquence spécifiée apparaît au début d’une étendue en lecture seule.
Trim<T>(ReadOnlySpan<T>, T)	Supprime toutes les occurrences de début et de fin d’un élément spécifié d’une étendue en lecture seule.
Trim<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Supprime d’une étendue en lecture seule 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>(ReadOnlySpan<T>, T)	Supprime d’une étendue en lecture seule toutes les occurrences de fin d’un élément spécifié.
TrimEnd<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)	Supprime d’une étendue en lecture seule toutes les occurrences de fin d’un jeu d’éléments spécifié dans une étendue en lecture seule.
TrimStart<T>(ReadOnlySpan<T>, T)	Supprime de l’étendue toutes les occurrences de début d’un élément spécifié.
TrimStart<T>(ReadOnlySpan<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 à