CKTIS / C#
Span и Memory: изгледи към буфери без копиране
Span<T> и Memory<T> описват области от съществуващи буфери, без да копират елементите им. Научете за ограниченията на живота им, вариантите само за четене и обработката на текст с AsSpan, IndexOf, SequenceEqual и TryParse.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> е записваем изглед към непрекъсната област от памет, докато ReadOnlySpan<T> позволява само четене чрез изгледа. Създаването или изрязването на изглед не копира елементи. Самият span е ref struct; данните му могат да се намират например в масив в heap паметта или в паметта на стека. ReadOnly ограничава достъпа чрез изгледа, но не гарантира, че буферът не може да бъде променен по друг път за достъп.
Memory<T> и ReadOnlyMemory<T> могат да се съхраняват в полета на класове и да се запазват след await; свойството им .Span предоставя изглед за синхронна обработка. Те не притежават буфера: не използвайте изглед след връщането на буфера в пул или след края на разрешения период на използване. Span не може да бъде прихванат в ламбда или съхранен в поле на клас. От C# 13 локалните span-ове са разрешени в методи async с ограничения; не могат да преживеят await. Преди C# 13 са били забранени в тези методи.
MemoryExtensions.AsSpan създава изглед; за string връща ReadOnlySpan<char> от UTF-16 кодови единици. MemoryExtensions.IndexOf връща първия индекс, броен от нула, или -1: проверете резултата, преди да изрежете. MemoryExtensions.SequenceEqual сравнява дължините и съответстващите елементи, а не идентичността на изгледите; за char не извършва езиково сравнение, зависещо от културата.
Int32.TryParse(ReadOnlySpan<char>, ...) и Decimal.TryParse(ReadOnlySpan<char>, ...) обработват отрязък, без да създават подниз. Проверете върнатия bool; задайте NumberStyles и CultureInfo.InvariantCulture за предвидим формат. И двата метода връщат false при невалиден запис на число, но невалидни аргументи за стила могат да предизвикат изключения. Int32.TryParse връща false и за стойности извън диапазона на Int32. За разлика от него Decimal.TryParse може да закръгли стойност, малко по-голяма от decimal.MaxValue, надолу до decimal.MaxValue и да върне true. Това се случва например при 79228162514264337593543950335.1 с NumberStyles.Number и CultureInfo.InvariantCulture.
UTF-8 низов литерал със суфикс u8, например "OK"u8, е наличен от C# 11 и създава ReadOnlySpan<byte>, а не string или ReadOnlySpan<char>. Дължината му брои байтове, а не знаци. Примерът е предназначен за net10.0 с LangVersion=preview, но използва утвърдени функции, които не изискват preview режим.
Референтни идентификатори, обхванати в тази статия: UTF-8 string literal u8.
Примери
using System;
using System.Globalization;
ReadOnlyMemory<char> memory = "42;12.50".AsMemory();
ReadOnlySpan<char> text = memory.Span;
int separator = text.IndexOf(';');
if (separator < 0)
throw new FormatException("Missing separator.");
bool countOk = int.TryParse(text[..separator], NumberStyles.Integer,
CultureInfo.InvariantCulture, out int count);
bool priceOk = decimal.TryParse(text[(separator + 1)..], NumberStyles.Number,
CultureInfo.InvariantCulture, out decimal price);
if (!countOk || !priceOk)
throw new FormatException("Invalid number.");
Console.WriteLine(text[..separator].SequenceEqual("42".AsSpan()));
Console.WriteLine((count * price).ToString("F2", CultureInfo.InvariantCulture));
ReadOnlySpan<byte> command = "OK"u8;
Console.WriteLine(command.SequenceEqual("OK"u8));Резултат
True 525.00 True
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.
Източници
- C# language reference
- Memory<T> and Span<T> usage guidelines
- ref struct types - C# reference
- Introduction to character encoding in .NET
- MemoryExtensions.AsSpan Method (System)
- MemoryExtensions.IndexOf Method (System)
- MemoryExtensions.SequenceEqual Method (System)
- Int32.TryParse Method (System)
- Decimal.TryParse Method (System)
- Official reference — learn.microsoft.com: api / system.readonlyspan-1
- Official reference — learn.microsoft.com: api / system.memoryextensions