Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

MemoryExtensions.AsSpan et IndexOf : rechercher dans une vue du texte

Créez une vue du texte sans copie, recherchez un élément ou une séquence, puis affichez la portion voulue avec `Console.Out.Write` sans créer de sous-chaîne.

Version : C# 12 and .NET 8; later runtimes may add compatible features

Syntaxe

using System;

// Selected .NET 8 signatures, declared in System.MemoryExtensions:
public static ReadOnlySpan<char> AsSpan(this string? text);
public static ReadOnlySpan<char> AsSpan(this string? text, int start);
public static ReadOnlySpan<char> AsSpan(this string? text, int start, int length);
public static Span<T> AsSpan<T>(this T[]? array);
public static int IndexOf<T>(this ReadOnlySpan<T> span, T value) where T : IEquatable<T>?;
public static int IndexOf<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value) where T : IEquatable<T>?;
public static int IndexOf(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType);

// Equivalent calls when the extension methods are in scope:
ReadOnlySpan<char> view = text.AsSpan(start, length);
ReadOnlySpan<char> sameView = System.MemoryExtensions.AsSpan(text, start, length);
int index = view.IndexOf('=');
int sameIndex = System.MemoryExtensions.IndexOf<char>(view, '=');

// Output uses a virtual instance method on System.IO.TextWriter:
Console.Out.Write(view);

AsSpan et IndexOf sont ici des méthodes d’extension statiques de System.MemoryExtensions. Avec using System;, text.AsSpan() équivaut à MemoryExtensions.AsSpan(text), et view.IndexOf('=') à MemoryExtensions.IndexOf<char>(view, '='). Il ne s’agit pas de méthodes d’instance de string et de ReadOnlySpan<char>, respectivement. string.IndexOf est une méthode d’instance distincte qui recherche dans la chaîne elle-même.

AsSpan() fournit un ReadOnlySpan<char> sur toute la chaîne, AsSpan(start) une vue de start jusqu’à la fin, et AsSpan(start, length) une vue de la longueur indiquée à partir de start. La vue ne copie pas les données et ne permet pas de les modifier. Sans décalage, AsSpan() renvoie une vue vide pour null ; des bornes invalides sur une chaîne non nulle déclenchent ArgumentOutOfRangeException. En revanche, AsSpan<T>(T[]) fournit un Span<T> modifiable sur le tableau.

Les surcharges génériques IndexOf<T> recherchent un élément T ou une séquence contiguë ReadOnlySpan<T>, en comparant les éléments avec IEquatable<T>.Equals. D’autres surcharges acceptent un Span<T> comme récepteur. Pour une séquence de char, on peut spécifier StringComparison : Ordinal respecte la casse et ne dépend pas de la culture. Le résultat est l’indice de la première occurrence, à partir de zéro et relatif à la vue, ou -1. Les indices du texte comptent les unités de code UTF-16, pas les caractères perçus. Vérifiez >= 0 avant d’utiliser le résultat comme indice ou borne de découpe.

Slice est une méthode d’instance qui crée une vue plus restreinte. Console.Out est de type System.IO.TextWriter : Console.Out.Write(view) appelle sa méthode d’instance virtuelle Write(ReadOnlySpan<char>) sans ajouter de fin de ligne. L’appelant n’a pas à créer de sous-chaîne ; cela ne garantit pas l’absence d’allocations internes au writer.

En C# 12, ReadOnlySpan<T> est un ref struct : impossible de le stocker dans un champ de classe, de le boxer ou de déclarer une variable de ce type dans une méthode async. L’exemple est synchrone et cible .NET 8 ; les versions ultérieures du runtime peuvent ajouter des fonctionnalités compatibles.

Exemples

using System;

const string input = "log:name=ada";
ReadOnlySpan<char> field = input.AsSpan(4, 8);

int separator = field.IndexOf('=');
int name = MemoryExtensions.IndexOf(field, "ada".AsSpan(), StringComparison.Ordinal);
int missing = field.IndexOf(':');

Console.WriteLine(FormattableString.Invariant($"{separator} {name} {missing}"));
if (separator >= 0)
{
    ReadOnlySpan<char> value = field.Slice(separator + 1);
    Console.Out.Write(value);
    Console.Out.WriteLine();
}

Résultat

4 5 -1
ada

La vue contient `name=ada` : `=` est à l’indice `4`, `ada` commence à `5` et `:` n’apparaît que dans le préfixe ignoré, d’où `-1`. `Slice(separator + 1)` sélectionne `ada` pour `Console.Out.Write`.

Leçons associées

  • C# · Leçon 9 · Avancé · Version : 3

Sources