CKTIS / C#
Rechercher, comparer et convertir des données dans des spans
Recherchez et comparez des vues de texte sans copie, puis convertissez des champs en `int` ou `decimal` avec des règles de format explicites.
Version : C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
using System;
using System.Globalization;
// Selected call forms for C# 12 / .NET 8:
ReadOnlySpan<char> text = sourceString.AsSpan();
ReadOnlySpan<char> part = sourceString.AsSpan(start, length);
Span<int> elements = sourceArray.AsSpan(); // sourceArray is int[]
int elementIndex = text.IndexOf(':');
int sequenceIndex = text.IndexOf(needle); // needle is ReadOnlySpan<char>
int textIndex = text.IndexOf(needle, StringComparison.OrdinalIgnoreCase);
bool same = text.SequenceEqual(needle);
bool sameIgnoringCase = MemoryExtensions.Equals(text, needle, StringComparison.OrdinalIgnoreCase);
bool intOk = int.TryParse(part, NumberStyles.None, CultureInfo.InvariantCulture, out int count);
bool decimalOk = decimal.TryParse(part, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out decimal price);En C# 12 et .NET 8, using System; donne accès aux méthodes d’extension de System.MemoryExtensions. AsSpan() crée une vue sans copie : un string donne un ReadOnlySpan<char> et un tableau T[] donne un Span<T> modifiable. La surcharge AsSpan<T> pour les tableaux lève une ArrayTypeMismatchException si le tableau est passé par covariance, par exemple si un string[] est passé en tant que object[]. AsSpan(start, length) sélectionne une portion ; des bornes invalides sur une source non nulle provoquent une ArgumentOutOfRangeException. La forme sans argument renvoie une vue vide pour une chaîne null. Les deux types de spans sont des ref struct : la vue ne doit pas survivre à sa mémoire sous-jacente. En C# 12, les variables locales de type span sont interdites dans les méthodes asynchrones et les itérateurs.
IndexOf recherche un élément ou une suite contiguë. Il renvoie l’indice de la première occurrence, à partir de zéro dans la vue parcourue, ou -1 en cas d’échec ; une suite vide donne 0. Vérifiez l’indice avant de découper la vue. Les surcharges génériques présentées utilisent IEquatable<T> ; pour char, elles comparent des unités de code UTF-16. Ne les confondez pas avec String.IndexOf : sa surcharge string utilise par défaut la culture courante, tandis que sa surcharge char est ordinale. Pour ignorer la casse dans une vue de texte, choisissez la surcharge avec StringComparison.OrdinalIgnoreCase.
SequenceEqual exige la même longueur et des éléments égaux aux positions correspondantes. Pour des spans de char, l’appel présenté distingue la casse et ne normalise pas Unicode ; pour ignorer la casse, utilisez MemoryExtensions.Equals avec StringComparison.OrdinalIgnoreCase. Pour les spans, == vérifie l’emplacement initial en mémoire et la longueur, pas le contenu. La méthode LINQ System.Linq.Enumerable.SequenceEqual prend des IEnumerable<T>, pas des spans. Ne supposez pas que SequenceEqual s’exécute en temps constant : pour des données secrètes sous forme d’octets de même longueur, utilisez CryptographicOperations.FixedTimeEquals.
int.TryParse et decimal.TryParse acceptent un ReadOnlySpan<char> sans créer de sous-chaîne. Adaptez NumberStyles et la culture au format : ici, NumberStyles.None n’active aucun élément de format facultatif, tandis que NumberStyles.AllowDecimalPoint autorise le séparateur décimal, soit . avec CultureInfo.InvariantCulture. Dans .NET 8, les deux méthodes ignorent les caractères U+0000 en fin de champ, même avec ces paramètres. Si le format les interdit, rejetez-les explicitement avant la conversion. N’utilisez la valeur out que si le résultat est true. Un champ vide ou un dépassement de la capacité du type entier donne false, mais une valeur NumberStyles non valide peut lever une exception.
Exemples
using System;
using System.Globalization;
ReadOnlySpan<char> record = "item:42;19.95".AsSpan();
int colon = record.IndexOf(":".AsSpan());
if (colon < 0 || !record[..colon].SequenceEqual("item".AsSpan()))
{
Console.WriteLine("Invalid record.");
return;
}
ReadOnlySpan<char> fields = record[(colon + 1)..];
int separator = fields.IndexOf(';');
var culture = CultureInfo.InvariantCulture;
if (separator < 0 ||
!int.TryParse(fields[..separator], NumberStyles.None, culture, out int count) ||
!decimal.TryParse(fields[(separator + 1)..], NumberStyles.AllowDecimalPoint, culture, out decimal price))
{
Console.WriteLine("Invalid record.");
return;
}
Console.WriteLine(FormattableString.Invariant($"count={count}; price={price:0.00}"));Résultat
count=42; price=19.95
Le programme vérifie l’étiquette `item`, trouve les deux séparateurs et convertit deux champs sans créer de sous-chaînes. L’indice du point-virgule est relatif à `fields`, pas à `record`.
Leçons associées
- C# · Leçon 55 · Avancé · Version : 3
Sources
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- MemoryExtensions.SequenceEqual Method (System)
- MemoryExtensions.Equals Method (System)
- ref struct types - C# reference
- ReadOnlySpan<T>.Equality(ReadOnlySpan<T>, ReadOnlySpan<T>) Operator (System)
- String.IndexOf Method (System)
- Enumerable.SequenceEqual Method (System.Linq)
- Int32.TryParse Method (System)
- Decimal.TryParse Method (System)
- CryptographicOperations.FixedTimeEquals Method (System.Security.Cryptography)