CKTIS / C#
Iskanje, primerjanje in pretvarjanje podatkov v pogledih span
Išči in primerjaj besedilo v pogledih brez kopiranja ter pretvori polja v `int` ali `decimal` z izrecnimi pravili zapisa.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
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 in .NET 8 so razširitvene metode razreda System.MemoryExtensions na voljo prek using System;. AsSpan() ustvari pogled brez kopiranja: iz string dobiš ReadOnlySpan<char>, iz polja T[] pa zapisljiv Span<T>. Preobremenitev AsSpan<T> za polja sproži ArrayTypeMismatchException, če polje posreduješ kovariantno, na primer če string[] posreduješ kot object[]. AsSpan(start, length) izbere odsek; neveljavne meje pri viru, ki ni null, sprožijo ArgumentOutOfRangeException. Klic brez argumentov za niz null vrne prazen pogled. Oba tipa span sta ref struct: pogled ne sme preživeti pomnilnika, na katerega se nanaša, v C# 12 pa lokalne spremenljivke tipa span v asinhronih metodah in iteratorjih niso dovoljene.
IndexOf išče posamezen element ali strnjeno zaporedje. Vrne prvi indeks, štet od nič v pregledanem pogledu, ali -1, če ni zadetka; prazno zaporedje vrne 0. Pred izrezom preveri rezultat. Prikazane generične preobremenitve uporabljajo IEquatable<T>; pri char primerjajo kodne enote UTF-16. To ni String.IndexOf: njegova preobremenitev za string privzeto uporablja trenutno kulturo, tista za char pa išče ordinalno. Za iskanje v besedilnem pogledu ne glede na velikost črk uporabi preobremenitev s StringComparison.OrdinalIgnoreCase.
SequenceEqual zahteva enako dolžino in enake elemente na ustreznih mestih. Pri pogledih elementov char prikazani klic razlikuje velike in male črke ter ne normalizira Unicode; za primerjavo ne glede na velikost črk uporabi MemoryExtensions.Equals s StringComparison.OrdinalIgnoreCase. Operator == pri pogledih span preveri začetno mesto v pomnilniku in dolžino, ne vsebine. Metoda LINQ System.Linq.Enumerable.SequenceEqual deluje z IEnumerable<T>, ne s pogledi span. Ne predpostavljaj, da SequenceEqual teče v konstantnem času; za primerjavo tajnih bajtnih podatkov enake dolžine uporabi CryptographicOperations.FixedTimeEquals.
int.TryParse in decimal.TryParse sprejmeta ReadOnlySpan<char> brez ustvarjanja podniza. Izberi NumberStyles in kulturo glede na zapis: tu NumberStyles.None ne omogoči nobenega izbirnega elementa zapisa, NumberStyles.AllowDecimalPoint pa dovoli decimalno ločilo, ki je pri CultureInfo.InvariantCulture znak .. V .NET 8 obe metodi tudi pri teh nastavitvah prezreta znake U+0000 na koncu polja. Če jih zapis ne dovoljuje, jih pred pretvorbo izrecno zavrni. Vrednost out uporabi le ob rezultatu true. Prazno polje ali prekoračitev obsega pri pretvorbi v int da rezultat false, vendar lahko neveljavna vrednost NumberStyles sproži izjemo.
Primeri
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}"));Rezultat
count=42; price=19.95
Program preveri oznako `item`, najde obe ločili in pretvori dve polji brez ustvarjanja podnizov. Indeks podpičja se nanaša na `fields`, ne na `record`.
Povezane lekcije
- C# · Lekcija 55 · Napredna · Različica: 3
Viri
- 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)