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