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

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"u8

Span<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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници