База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C#

Търсене, сравняване и преобразуване на данни в изгледи span

Търси и сравнявай текстови изгледи без копиране и преобразувай полета в `int` или `decimal` с изрични правила за формата.

Версия: C# 12 and .NET 8; later runtimes may add compatible features

Синтаксис

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

В C# 12 и .NET 8 using System; осигурява достъп до разширяващите методи на System.MemoryExtensions. AsSpan() създава изглед без копиране: от string получаваш ReadOnlySpan<char>, а от масив T[] — Span<T> с възможност за запис. Претоварването AsSpan<T> за масиви предизвиква ArrayTypeMismatchException, ако масивът е подаден ковариантно, например когато подадеш string[] като object[]. AsSpan(start, length) избира отрязък; невалидните граници при източник, различен от null, предизвикват ArgumentOutOfRangeException. Вариантът без аргументи връща празен изглед за низ null. И двата типа span са ref struct: изгледът не трябва да надживява паметта, към която сочи. В C# 12 локални променливи от тип span не са допустими в асинхронни методи и итератори.

IndexOf търси един елемент или последователност от съседни елементи. Връща първия индекс, броен от нула в претърсвания изглед, или -1, ако няма съвпадение; за празна последователност връща 0. Провери резултата, преди да избереш отрязък. Показаните обобщени претоварвания използват IEquatable<T>; за char сравняват кодови единици UTF-16. Това не е String.IndexOf: претоварването му за string по подразбиране използва текущата култура, а това за char търси ординално. За търсене в текстов изглед без разграничаване на главни и малки букви използвай претоварването със StringComparison.OrdinalIgnoreCase.

SequenceEqual изисква еднаква дължина и равни елементи на съответните позиции. За изгледи с елементи char показаното извикване разграничава главни и малки букви и не нормализира Unicode; за сравнение без разграничаване използвай MemoryExtensions.Equals със StringComparison.OrdinalIgnoreCase. При span операторът == проверява началното място в паметта и дължината, а не съдържанието. Методът на LINQ System.Linq.Enumerable.SequenceEqual работи с IEnumerable<T>, не със span. Не приемай, че SequenceEqual работи за константно време; за тайни байтови данни с еднаква дължина използвай CryptographicOperations.FixedTimeEquals.

int.TryParse и decimal.TryParse приемат ReadOnlySpan<char>, без да създават подниз. Избери NumberStyles и култура според формата: тук NumberStyles.None не разрешава незадължителни елементи на формата, а NumberStyles.AllowDecimalPoint допуска десетичния разделител, който в CultureInfo.InvariantCulture е .. В .NET 8 и двата метода пренебрегват знаците U+0000 в края на полето дори с тези настройки. Ако форматът не ги допуска, отхвърли ги изрично преди преобразуването. Използвай стойността out само при true. Празно поле или стойност извън диапазона при преобразуване към int дава false, но невалидна стойност на NumberStyles може да предизвика изключение.

Примери

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

Резултат

count=42; price=19.95

Програмата проверява етикета `item`, намира двата разделителя и преобразува две полета без създаване на поднизове. Индексът на точката и запетаята е спрямо `fields`, а не спрямо `record`.

Свързани уроци

  • C# · Урок 55 · Напреднало · Версия: 3

Източници