CKTIS / C#
MemoryExtensions.AsSpan и IndexOf: търсене в изглед към текст
Създай изглед към текст без копиране, потърси елемент или последователност и изведи откъса чрез `Console.Out.Write`, без да създаваш подниз.
Версия: C# 12 and .NET 8; later runtimes may add compatible features
Синтаксис
using System;
// Selected .NET 8 signatures, declared in System.MemoryExtensions:
public static ReadOnlySpan<char> AsSpan(this string? text);
public static ReadOnlySpan<char> AsSpan(this string? text, int start);
public static ReadOnlySpan<char> AsSpan(this string? text, int start, int length);
public static Span<T> AsSpan<T>(this T[]? array);
public static int IndexOf<T>(this ReadOnlySpan<T> span, T value) where T : IEquatable<T>?;
public static int IndexOf<T>(this ReadOnlySpan<T> span, ReadOnlySpan<T> value) where T : IEquatable<T>?;
public static int IndexOf(this ReadOnlySpan<char> span, ReadOnlySpan<char> value, StringComparison comparisonType);
// Equivalent calls when the extension methods are in scope:
ReadOnlySpan<char> view = text.AsSpan(start, length);
ReadOnlySpan<char> sameView = System.MemoryExtensions.AsSpan(text, start, length);
int index = view.IndexOf('=');
int sameIndex = System.MemoryExtensions.IndexOf<char>(view, '=');
// Output uses a virtual instance method on System.IO.TextWriter:
Console.Out.Write(view);AsSpan и IndexOf тук са статични методи за разширение на System.MemoryExtensions. С using System; извикването text.AsSpan() е равностойно на MemoryExtensions.AsSpan(text), а view.IndexOf('=') — на MemoryExtensions.IndexOf<char>(view, '='). Това не са методи на екземпляр съответно на string и ReadOnlySpan<char>. string.IndexOf е отделен метод на екземпляр, който търси в самия низ.
AsSpan() връща ReadOnlySpan<char> върху целия низ, AsSpan(start) — изглед от start до края, а AsSpan(start, length) — изглед със зададената дължина от start. Изгледът не копира данните и не позволява запис през него. AsSpan() без отместване връща празен изглед за null; невалидни граници при низ, различен от null, предизвикват ArgumentOutOfRangeException. За разлика от него, AsSpan<T>(T[]) връща Span<T>, през който може да се записва в масива.
Обобщените претоварвания на IndexOf<T> търсят един елемент T или непрекъсната последователност ReadOnlySpan<T>, като сравняват елементите с IEquatable<T>.Equals. Има и претоварвания с получател Span<T>. За последователност от char можеш да зададеш StringComparison: Ordinal различава главни от малки букви и не зависи от езиковите настройки. Резултатът е индексът на първото съвпадение, броен от нула спрямо изгледа, или -1. Текстовите индекси броят кодови единици на UTF-16, а не знаци така, както ги възприема читателят. Провери >= 0, преди да използваш резултата за индексиране или вземане на откъс.
Slice е метод на екземпляр, който връща по-тесен изглед. Console.Out е от тип System.IO.TextWriter, така че Console.Out.Write(view) извиква виртуалния му метод на екземпляр Write(ReadOnlySpan<char>), без да добавя нов ред. Извикващият код не създава подниз; това не гарантира, че обектът за запис не заделя памет вътрешно.
В C# 12 ReadOnlySpan<T> е тип ref struct: не може да се съхрани в поле на клас, да се опакова чрез boxing или да се декларира променлива от този тип в метод async. Примерът е синхронен и е предназначен за .NET 8; по-нови среди за изпълнение могат да добавят съвместими възможности.
Примери
using System;
const string input = "log:name=ada";
ReadOnlySpan<char> field = input.AsSpan(4, 8);
int separator = field.IndexOf('=');
int name = MemoryExtensions.IndexOf(field, "ada".AsSpan(), StringComparison.Ordinal);
int missing = field.IndexOf(':');
Console.WriteLine(FormattableString.Invariant($"{separator} {name} {missing}"));
if (separator >= 0)
{
ReadOnlySpan<char> value = field.Slice(separator + 1);
Console.Out.Write(value);
Console.Out.WriteLine();
}Резултат
4 5 -1 ada
Изгледът съдържа `name=ada`: `=` е на индекс `4`, `ada` започва на `5`, а `:` е само в пропуснатия префикс и затова търсенето му връща `-1`. `Slice(separator + 1)` избира `ada` за `Console.Out.Write`.
Свързани уроци
- C# · Урок 9 · Напреднало · Версия: 3
Източници
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- Extension members (C# Programming Guide)
- String.IndexOf Method (System)
- ReadOnlySpan<T>.Slice Method (System)
- ref structure types (C# reference)
- Introduction to character encoding in .NET
- Best practices for comparing strings in .NET
- Console.Out Property (System)
- TextWriter.Write Method (System.IO) — Write(ReadOnlySpan<Char>)