Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Vyhledávání, porovnávání a převod dat v pohledech span

Vyhledávej a porovnávej text v pohledech bez kopírování a převáděj pole na `int` nebo `decimal` podle výslovných pravidel formátu.

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

V C# 12 a .NET 8 zpřístupní using System; rozšiřující metody třídy System.MemoryExtensions. AsSpan() vytvoří pohled bez kopírování: z string získáš ReadOnlySpan<char>, z pole T[] zapisovatelný Span<T>. Přetížení AsSpan<T> pro pole vyvolá ArrayTypeMismatchException, pokud pole předáš kovariantně, například když string[] předáš jako object[]. AsSpan(start, length) vybere výřez; neplatné hranice u zdroje různého od null vyvolají ArgumentOutOfRangeException. Volání bez argumentů vrátí pro řetězec null prázdný pohled. Oba typy span jsou ref struct: pohled nesmí přežít podkladovou paměť a v C# 12 nelze deklarovat místní proměnné typu span v asynchronních metodách ani iterátorech.

IndexOf hledá jeden prvek nebo souvislou posloupnost. Vrací první index počítaný od nuly v prohledávaném pohledu, nebo -1, pokud shodu nenajde; u prázdné posloupnosti vrátí 0. Před vytvořením výřezu výsledek zkontroluj. Ukázaná generická přetížení používají IEquatable<T>; pro char porovnávají kódové jednotky UTF-16. Nejde o String.IndexOf: jeho přetížení pro string standardně používá aktuální jazykové prostředí, zatímco přetížení pro char hledá ordinálně. Pro hledání v textovém pohledu bez rozlišení velikosti písmen použij přetížení se StringComparison.OrdinalIgnoreCase.

SequenceEqual vyžaduje stejnou délku a shodné prvky na odpovídajících pozicích. U pohledů s prvky char ukázané volání rozlišuje velikost písmen a nenormalizuje Unicode; bez rozlišení velikosti písmen použij MemoryExtensions.Equals se StringComparison.OrdinalIgnoreCase. Operátor == u spanů kontroluje počáteční místo v paměti a délku, nikoli obsah. Metoda LINQ System.Linq.Enumerable.SequenceEqual pracuje s IEnumerable<T>, ne se spany. U SequenceEqual nepředpokládej konstantní dobu běhu; pro tajná bajtová data stejné délky použij CryptographicOperations.FixedTimeEquals.

int.TryParse a decimal.TryParse přijímají ReadOnlySpan<char> bez vytváření podřetězce. Zvol NumberStyles a jazykové prostředí podle formátu: zde NumberStyles.None nepovoluje žádné volitelné součásti formátu, zatímco NumberStyles.AllowDecimalPoint povoluje desetinný oddělovač, kterým je v CultureInfo.InvariantCulture znak .. V .NET 8 obě metody i s tímto nastavením ignorují znaky U+0000 na konci pole. Pokud je formát zakazuje, výslovně je odmítni před převodem. Hodnotu out použij jen při výsledku true. Prázdné pole nebo přetečení při převodu na int vede k výsledku false, neplatná hodnota NumberStyles ale může vyvolat výjimku.

Příklady

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

Výsledek

count=42; price=19.95

Program ověří označení `item`, najde oba oddělovače a převede dvě pole bez vytváření podřetězců. Index středníku je relativní k `fields`, ne k `record`.

Související lekce

  • C# · Lekce 55 · Pokročilá · Verze: 3

Zdroje