KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

Spans doorzoeken, vergelijken en als getallen lezen

Doorzoek en vergelijk tekstweergaven zonder te kopiëren en lees velden als `int` of `decimal` met expliciete opmaakregels.

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

Syntax

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

In C# 12 en .NET 8 zijn de extensiemethoden van System.MemoryExtensions beschikbaar via using System;. AsSpan() maakt een weergave zonder kopie: een string levert een ReadOnlySpan<char> op en een T[] een beschrijfbare Span<T>. De overbelasting AsSpan<T> voor arrays werpt een ArrayTypeMismatchException op als je een array covariant doorgeeft, bijvoorbeeld als je een string[] doorgeeft als object[]. AsSpan(start, length) selecteert een deel; ongeldige grenzen bij een bron die niet null is, leiden tot ArgumentOutOfRangeException. De vorm zonder argumenten geeft een lege weergave voor een null-tekenreeks. Beide spantypen zijn ref struct: de weergave mag niet langer bestaan dan het onderliggende geheugen. In C# 12 zijn lokale spanvariabelen niet toegestaan in asynchrone methoden of iterators.

IndexOf zoekt één element of een aaneengesloten reeks. De methode geeft de eerste index vanaf nul binnen de doorzochte weergave, of -1 als er geen treffer is; een lege zoekreeks geeft 0. Controleer de index voordat je een deel selecteert. De getoonde generieke overbelastingen gebruiken IEquatable<T>; voor char vergelijken ze UTF-16-code-eenheden. Dit is niet hetzelfde als String.IndexOf: de string-overbelasting gebruikt standaard de huidige cultuur, de char-overbelasting zoekt ordinaal. Voor hoofdletterongevoelig zoeken in een tekstspan gebruik je de overbelasting met StringComparison.OrdinalIgnoreCase.

SequenceEqual vereist dezelfde lengte en gelijke elementen op overeenkomstige posities. Bij char-spans is de getoonde aanroep hoofdlettergevoelig en wordt Unicode niet genormaliseerd. Gebruik voor hoofdletterongevoelige gelijkheid MemoryExtensions.Equals met StringComparison.OrdinalIgnoreCase. Bij spans controleert == de beginlocatie in het geheugen en de lengte, niet de inhoud. LINQ's System.Linq.Enumerable.SequenceEqual werkt met IEnumerable<T>, niet met spans. Ga er niet van uit dat SequenceEqual een constante looptijd heeft; gebruik voor geheime bytegegevens van gelijke lengte CryptographicOperations.FixedTimeEquals.

int.TryParse en decimal.TryParse accepteren ReadOnlySpan<char> zonder een deeltekenreeks te maken. Kies NumberStyles en een cultuur die bij de invoer passen: hier schakelt NumberStyles.None geen optionele opmaakelementen in, terwijl NumberStyles.AllowDecimalPoint het decimaalteken toestaat, dat bij CultureInfo.InvariantCulture een . is. In .NET 8 negeren beide methoden U+0000-tekens aan het einde van het veld, zelfs met deze instellingen. Als je indeling die tekens verbiedt, wijs ze dan expliciet af voordat je het getal inleest. Gebruik de out-waarde alleen bij true. Een leeg veld of een geheel getal buiten het bereik van int geeft false bij het inlezen als int; een ongeldige NumberStyles-waarde kan een uitzondering veroorzaken.

Voorbeelden

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}"));

Resultaat

count=42; price=19.95

Het programma controleert het label `item`, vindt beide scheidingstekens en leest twee velden zonder deeltekenreeksen te maken. De puntkomma-index is relatief aan `fields`, niet aan `record`.

Gerelateerde lessen

  • C# · Les 55 · Gevorderd · Versie: 3

Bronnen