Partager via


ReadOnlySpan<T> Structure

Définition

Fournit une représentation en lecture seule de type sécurisé et en mémoire sécurisée d’une région 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 le ReadOnlySpan<T>.

Héritage
ReadOnlySpan<T>
Attributs

Remarques

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

Une instance ReadOnlySpan<T> est souvent utilisée pour référencer les éléments d’un tableau ou une partie d’un tableau. Contrairement à un tableau, toutefois, une instance de ReadOnlySpan<T> 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 une ReadOnlySpan<T> de longueur 1 autour de la référence spécifiée.

ReadOnlySpan<T>(T[])

Crée une ReadOnlySpan<T> sur l’intégralité d’un tableau spécifié.

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

Crée une nouvelle ReadOnlySpan<T> qui inclut un nombre spécifié d’éléments d’un tableau commençant à un index spécifié.

ReadOnlySpan<T>(Void*, Int32)

Crée une 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 une ReadOnlySpan<T>vide.

IsEmpty

Renvoie 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

CastUp<TDerived>(ReadOnlySpan<TDerived>)

Convertit une étendue en lecture seule de TDerived en une étendue en lecture seule de T.

CopyTo(Span<T>)

Copie le contenu de cette ReadOnlySpan<T> dans une Span<T>de destination.

Equals(Object)
Obsolète.
Obsolète.

Non pris en charge. Lève une NotSupportedException.

GetEnumerator()

Retourne un énumérateur pour cette ReadOnlySpan<T>.

GetHashCode()
Obsolète.

Non pris en charge. Lève une NotSupportedException.

GetPinnableReference()

Renvoie 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)

Forme une tranche de l’étendue en lecture seule actuelle qui commence à un index spécifié.

Slice(Int32, Int32)

Forme une tranche de l’étendue en lecture seule actuelle à partir d’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 cette ReadOnlySpan<T>.

TryCopyTo(Span<T>)

Tente de copier le contenu de cette ReadOnlySpan<T> dans un Span<T> et retourne une valeur pour indiquer si l’opération a réussi ou non.

Opérateurs

Equality(ReadOnlySpan<T>, ReadOnlySpan<T>)

Retourne une valeur qui indique si deux instances 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 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 ReadOnlySpan<T> triée entière pour une valeur à l’aide de l’interface générique IComparable<T> spécifiée.

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

Recherche une ReadOnlySpan<T> triée entière pour une valeur spécifiée à l’aide du type générique TComparer spécifié.

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

Recherche une ReadOnlySpan<T> triée entière pour une valeur à l’aide du type générique spécifié TComparable.

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

Recherche la longueur d’un préfixe commun partagé entre span et other.

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

Détermine la longueur d’un 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 à l’aide d’IEquatable{T}. Equals(T).

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

Recherche une occurrence de value0 ou de value1.

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

Recherche une occurrence de value0, value1ou value2.

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

Recherche une occurrence de l’une des valuesspécifiées.

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

Recherche une occurrence de l’une des valuesspécifiées.

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

Recherche une valeur autre que la valuespécifiée.

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

Recherche n’importe quelle valeur autre que value0 ou value1.

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

Recherche une valeur autre que value0, value1ou value2.

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

Recherche une valeur autre que la valuesspécifiée.

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

Recherche une valeur autre que la valuesspécifiée.

ContainsAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)

Recherche une valeur en dehors de la plage comprise entre lowInclusive et highInclusive, inclusive.

ContainsAnyInRange<T>(ReadOnlySpan<T>, T, T)

Recherche une valeur quelconque dans la plage comprise entre lowInclusive et highInclusive, inclusive.

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

Compte le nombre de fois où le value spécifié 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>, T)

Détermine si la valeur spécifiée apparaît à la fin de l’étendue.

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 à l’aide d’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 à l’aide d’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 la valuespécifiée.

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

Recherche le premier index d’une valeur autre que la value0 spécifiée ou value1.

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

Recherche le premier index d’une valeur autre que la value0spécifiée, value1ou value2.

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

Recherche le premier index d’une valeur autre que la valuesspécifiée.

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

Recherche le premier index d’une valeur autre que la valuesspécifiée.

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 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 à l’aide d’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 à l’aide d’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 d’une valeur autre que la valuespécifiée.

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

Recherche le dernier index d’une valeur autre que la value0 spécifiée ou value1.

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

Recherche le dernier index d’une valeur autre que la value0spécifiée, value1ou value2.

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

Recherche le dernier index d’une valeur autre que la valuesspécifiée.

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

Recherche le dernier index d’une valeur autre que la valuesspécifiée.

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 comprise entre lowInclusive et highInclusive, inclus.

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

Détermine si deux séquences en lecture seule se chevauchent en mémoire.

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

Détermine si deux séquences en lecture seule se chevauchent en mémoire et génère le décalage d’élément.

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

Copie source dans destination, en remplaçant toutes les occurrences de oldValue par newValue.

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

Détermine l’ordre relatif de deux séquences en lecture seule en comparant leurs éléments à l’aide d’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 à l’aide d’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>.

Split<T>(ReadOnlySpan<T>, T)

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

Split<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

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

SplitAny<T>(ReadOnlySpan<T>, SearchValues<T>)

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

SplitAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

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

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

Détermine si la valeur spécifiée apparaît au début de l’étendue.

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 toutes les occurrences de début et de fin d’un ensemble d’éléments spécifiés dans une étendue en lecture seule d’une étendue en lecture seule.

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

Supprime toutes les occurrences de fin d’un élément spécifié d’une étendue en lecture seule.

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

Supprime toutes les occurrences de fin d’un ensemble d’éléments spécifiés dans une étendue en lecture seule d’une étendue en lecture seule.

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

Supprime toutes les occurrences principales d’un élément spécifié de l’étendue.

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

Supprime toutes les occurrences principales d’un ensemble d’éléments spécifiés dans une étendue en lecture seule de l’étendue.

S’applique à

Voir aussi