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
[System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))]
public readonly ref struct ReadOnlySpan<T>
public readonly ref struct ReadOnlySpan<T>
[<System.Runtime.InteropServices.Marshalling.NativeMarshalling(typeof(System.Runtime.InteropServices.Marshalling.ReadOnlySpanMarshaller<,>))>]
type ReadOnlySpan<'T> = struct
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 qui est alloué sur la pile et ne peut jamais é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ées à dynamic des variables et qu’ils ne peuvent pas implémenter n’importe quel 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, une 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

Nom Description
ReadOnlySpan<T>(T)

Crée une longueur ReadOnlySpan<T> de longueur 1 autour de la référence spécifiée.

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

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

ReadOnlySpan<T>(T[])

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

ReadOnlySpan<T>(Void*, Int32)

Crée un élément à ReadOnlySpan<T> partir d’un nombre spécifié d’éléments T commençant à une adresse mémoire spécifiée.

Propriétés

Nom Description
Empty

Retourne un objet vide ReadOnlySpan<T>.

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

Nom Description
CastUp<TDerived>(ReadOnlySpan<TDerived>)

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

CopyTo(Span<T>)

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

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

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 .NET compilateurs et n’est pas destinée à être appelée par le code utilisateur.

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.

Slice(Int32)

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

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 ce ReadOnlySpan<T>.

TryCopyTo(Span<T>)

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

Opérateurs

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

Retourne une valeur qui indique si deux ReadOnlySpan<T> instances 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 un ReadOnlySpan<T>.

Inequality(ReadOnlySpan<T>, ReadOnlySpan<T>)

Retourne une valeur qui indique si deux ReadOnlySpan<T> instances ne sont pas égales.

Méthodes d’extension

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

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

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

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

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

Recherche une valeur entière triée ReadOnlySpan<T> à l’aide de l’interface générique spécifiée IComparable<T> .

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

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

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

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

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

Recherche la valeur spécifiée et retourne true si elle est trouvée. S’il n’est pas trouvé, retourne false.

Contains<T>(ReadOnlySpan<T>, T)

Indique si une valeur spécifiée est trouvée dans une étendue en lecture seule.

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

Recherche une occurrence de l’une des occurrences spécifiées values et retourne true si elle est trouvée. S’il n’est pas trouvé, retourne false.

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

Recherche une occurrence de l’un des fichiers spécifiés values.

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

Recherche une occurrence de l’un des fichiers spécifiés values.

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

Recherche une occurrence de l’une des valeurs spécifiées.

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

Recherche toute occurrence des valeurs spécifiées dans l’étendue spécifiée.

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

Recherche une occurrence de value0, value1ou value2 dans l’étendue spécifiée.

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

Recherche une occurrence de value0 ou value1.

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

Recherche l’étendue spécifiée pour n’importe quelle valeur autre que celle spécifiée values.

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

Recherche l’étendue spécifiée pour n’importe quelle valeur autre que celle spécifiée values.

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

Recherche l’étendue spécifiée pour n’importe quelle valeur autre que celle spécifiée values.

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

Recherche l’étendue spécifiée pour toute valeur autre que value.

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

Recherche une valeur autre que value0 ou value1.

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

Recherche une valeur autre que value0, value1ou value2.

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

Recherche une valeur autre que value0, value1ou value2.

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

Recherche l’étendue spécifiée pour toute valeur autre que value0 ou value1.

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

Recherche l’étendue spécifiée pour n’importe quelle valeur autre que celle spécifiée value.

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

Recherche une valeur en dehors de la plage comprise entre lowInclusive et highInclusiveinclus.

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

Recherche n’importe quelle valeur dans la plage comprise entre lowInclusive et highInclusiveinclus.

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

Compte le nombre de fois où la valeur spécifiée value se produit dans le span.

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

Compte le nombre de fois valuespandans .

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

Compte le nombre de fois où la valeur spécifiée value se produit dans le span.

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

Compte le nombre de fois où la valeur spécifiée value se produit dans le span.

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

Compte le nombre de fois où l’un des événements spécifiés values se produit dans le span.

CountAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>)

Compte le nombre de fois où l’un des événements spécifiés values se produit dans le span.

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

Compte le nombre de fois où l’un des événements spécifiés values se produit dans le span.

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

Détermine si la séquence spécifiée apparaît à la fin de l’étendue en lecture seule.

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.

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

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

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

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

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

Recherche la séquence spécifiée et retourne l’index de sa première occurrence.

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

Recherche la séquence spécifiée et retourne l’index de sa première occurrence.

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

Recherche la valeur spécifiée et retourne l’index de sa première occurrence.

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

Recherche la valeur spécifiée et retourne l’index de sa première occurrence.

IndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<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.

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

Recherche le premier index de l’une des valeurs spécifiées.

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

Recherche le premier index de l’une des valeurs spécifiées.

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

Recherche le premier index de l’une des valeurs spécifiées.

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

Recherche le premier index de l’une des valeurs spécifiées.

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

Recherche le premier index de l’une des valeurs spécifiées.

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

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

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

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

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

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

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

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

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

Recherche le premier index d’une valeur autre que les deux valeurs spécifiées.

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

Recherche le premier index d’une valeur autre que value0, value1ou value2.

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

Recherche le premier index d’une valeur autre que value0, value1ou value2.

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

Recherche le premier index d’une valeur autre que les deux valeurs spécifiées.

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

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

IndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)

Recherche le premier index d’une valeur en dehors de la plage comprise entre lowInclusive et highInclusiveinclus.

IndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)

Recherche le premier index d’une valeur comprise entre lowInclusive et highInclusiveinclus.

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

Recherche la séquence spécifiée et retourne l’index de sa dernière occurrence. S’il est introuvable, retourne -1.

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

Recherche la séquence spécifiée et retourne l’index de sa dernière occurrence.

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

Recherche la valeur spécifiée et retourne l’index de sa dernière occurrence. S’il est introuvable, retourne -1.

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

Recherche la valeur spécifiée et retourne l’index de sa dernière occurrence.

LastIndexOfAny<T>(ReadOnlySpan<T>, ReadOnlySpan<T>, IEqualityComparer<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.

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

Recherche le dernier index de l’une des valeurs spécifiées.

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

Recherche le dernier index de l’une des valeurs spécifiées.

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

Recherche le dernier index de l’une des valeurs spécifiées.

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

Recherche le dernier index de l’une des valeurs spécifiées.

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

Recherche le dernier index de l’une des valeurs spécifiées.

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

Recherche le dernier index d’une valeur autre que celle spécifiée values.

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

Recherche le dernier index d’une valeur autre que celle spécifiée values.

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

Recherche le dernier index d’une valeur autre que celle spécifiée values.

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

Recherche le dernier index d’une valeur autre que celle spécifiée value.

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

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

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

Recherche le dernier index de n’importe quelle valeur autre que le value0, value1ou value2.

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

Recherche le dernier index de n’importe quelle valeur autre que le value0, value1ou value2.

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

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

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

Recherche le dernier index d’une valeur autre que celle spécifiée value.

LastIndexOfAnyExceptInRange<T>(ReadOnlySpan<T>, T, T)

Recherche le dernier index de n’importe quelle valeur en dehors de la plage comprise entre lowInclusive et highInclusiveinclus.

LastIndexOfAnyInRange<T>(ReadOnlySpan<T>, T, T)

Recherche le dernier index d’une valeur comprise entre lowInclusive et highInclusiveinclus.

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.

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

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

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

Copie source vers destination, en remplaçant toutes les occurrences de newValueoldValue .

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

Copie source vers destination, en remplaçant toutes les occurrences de newValueoldValue .

ReplaceAny<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)

Copie source vers destination, en remplaçant toutes les occurrences de l’un des éléments dans valuesnewValue.

ReplaceAnyExcept<T>(ReadOnlySpan<T>, Span<T>, SearchValues<T>, T)

Copie source vers destination, en remplaçant toutes les occurrences d’un des éléments autres que ceux inclus par valuesnewValue.

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

Détermine l’ordre relatif des séquences comparées en comparant les éléments à l’aide d’IComparable{T}. CompareTo(T).

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>, IEqualityComparer<T>)

Détermine si deux séquences sont égales en comparant les éléments à l’aide d’un IEqualityComparer<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).

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

Retourne un type qui autorise l’énumération de chaque élément dans une étendue fractionnée à l’aide de l’étendue de séparateur fournie.

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

Retourne un type qui permet l’énumération de chaque élément dans une étendue fractionnée à l’aide du caractère séparateur fourni.

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

Retourne un type qui autorise l’énumération de chaque élément dans une étendue fractionnée à l’aide de l’un des éléments fournis.

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

Retourne un type qui autorise l’énumération de chaque élément dans une étendue fractionnée à l’aide des caractères de séparateur fournis.

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

Détermine si une séquence spécifiée apparaît au début d’une étendue en lecture seule.

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.

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

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

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

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

ToImmutableArray<T>(ReadOnlySpan<T>)

Produire un tableau immuable de contenu à partir d’éléments spécifiés.

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.

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.

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.

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

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

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.

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

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

S’applique à

Voir aussi