Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

Vyhľadávanie, porovnávanie a prevod údajov v pohľadoch span

Vyhľadávaj a porovnávaj text v pohľadoch bez kopírovania a prevádzaj polia na `int` alebo `decimal` podľa explicitných pravidiel formátu.

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

V C# 12 a .NET 8 sprístupní using System; rozširujúce metódy triedy System.MemoryExtensions. AsSpan() vytvorí pohľad bez kopírovania: z string dostaneš ReadOnlySpan<char> a z poľa T[] zapisovateľný Span<T>. Preťaženie AsSpan<T> pre polia vyvolá ArrayTypeMismatchException, ak pole odovzdáš kovariantne, napríklad keď string[] odovzdáš ako object[]. AsSpan(start, length) vyberie výrez; neplatné hranice pri zdroji odlišnom od null vyvolajú ArgumentOutOfRangeException. Volanie bez argumentov vráti pre reťazec null prázdny pohľad. Oba typy span sú ref struct: pohľad nesmie prežiť podkladovú pamäť a v C# 12 nemožno deklarovať lokálne premenné typu span v asynchrónnych metódach ani iterátoroch.

IndexOf hľadá prvok alebo súvislú postupnosť. Vráti prvý index počítaný od nuly v prehľadávanom pohľade alebo -1, ak nič nenájde; prázdna postupnosť dá 0. Pred vytvorením výrezu výsledok skontroluj. Ukázané generické preťaženia používajú IEquatable<T>; pre char porovnávajú kódové jednotky UTF-16. Nie je to String.IndexOf: jeho preťaženie pre string predvolene používa aktuálnu kultúru, kým preťaženie pre char vyhľadáva ordinálne. Na vyhľadávanie v textovom pohľade bez rozlíšenia veľkosti písmen použi preťaženie so StringComparison.OrdinalIgnoreCase.

SequenceEqual vyžaduje rovnakú dĺžku a rovnaké prvky na zodpovedajúcich pozíciách. Pri pohľadoch s prvkami char ukázané volanie rozlišuje veľkosť písmen a nenormalizuje Unicode. Na porovnanie bez rozlíšenia veľkosti písmen použi MemoryExtensions.Equals so StringComparison.OrdinalIgnoreCase. Operátor == pri spanoch kontroluje počiatočné miesto v pamäti a dĺžku, nie obsah. Metóda LINQ System.Linq.Enumerable.SequenceEqual pracuje s IEnumerable<T>, nie so spanmi. Pri SequenceEqual nepredpokladaj konštantný čas; pre tajné bajtové údaje rovnakej dĺžky použi CryptographicOperations.FixedTimeEquals.

int.TryParse a decimal.TryParse prijímajú ReadOnlySpan<char> bez vytvárania podreťazca. Vyber NumberStyles a kultúru podľa formátu: tu NumberStyles.None nepovoľuje žiadne voliteľné prvky formátu, kým NumberStyles.AllowDecimalPoint povoľuje desatinný oddeľovač, ktorým je v CultureInfo.InvariantCulture znak .. V .NET 8 obe metódy aj pri týchto nastaveniach ignorujú znaky U+0000 na konci poľa. Ak ich formát zakazuje, pred prevodom ich výslovne odmietni. Hodnotu out použi len pri true. Prázdne pole alebo pretečenie pri prevode na int vedie k výsledku false, ale neplatná hodnota NumberStyles môže vyvolať výnimku.

Prí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ýsledok

count=42; price=19.95

Program overí označenie `item`, nájde oba oddeľovače a prevedie dve polia bez vytvárania podreťazcov. Index bodkočiarky je relatívny k `fields`, nie k `record`.

Súvisiace lekcie

  • C# · Lekcia 55 · Pokročilá · Verzia: 3

Zdroje