Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Span a Memory: pohledy na buffery bez kopírování

Span<T> a Memory<T> popisují oblasti existujících bufferů, aniž by kopírovaly jejich prvky. Seznamte se s omezeními jejich životnosti, variantami pouze pro čtení a zpracováním textu pomocí AsSpan, IndexOf, SequenceEqual a TryParse.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8

Span<T> je zapisovatelný pohled na souvislou oblast paměti, zatímco ReadOnlySpan<T> umožňuje prostřednictvím pohledu pouze čtení. Vytvoření pohledu ani jeho výřezu nekopíruje prvky. Samotný span je ref struct; jeho data mohou být například v poli na haldě nebo v paměti zásobníku. ReadOnly omezuje přístup prostřednictvím pohledu, ale nezaručuje, že buffer nelze změnit jinou cestou přístupu.

Memory<T> a ReadOnlyMemory<T> lze ukládat do polí tříd a zachovat i po await; jejich vlastnost .Span zpřístupňuje pohled pro synchronní zpracování. Buffer nevlastní: nepoužívejte pohled poté, co byl buffer vrácen do poolu nebo skončila povolená doba jeho používání. Span nelze zachytit v lambda výrazu ani uložit do pole třídy. Od C# 13 jsou lokální spany v metodách async povoleny s omezeními; nesmějí přežít await. Před C# 13 byly v těchto metodách zakázány.

MemoryExtensions.AsSpan vytvoří pohled; pro string vrací ReadOnlySpan<char> tvořený jednotkami kódu UTF-16. MemoryExtensions.IndexOf vrací první index počítaný od nuly, nebo -1: před vytvořením výřezu výsledek ověřte. MemoryExtensions.SequenceEqual porovnává délky a odpovídající prvky, nikoli totožnost pohledů; pro char neprovádí jazykové porovnání závislé na kultuře.

Int32.TryParse(ReadOnlySpan<char>, ...) a Decimal.TryParse(ReadOnlySpan<char>, ...) zpracují výřez bez vytvoření podřetězce. Ověřte vrácenou hodnotu bool; pro předvídatelný formát zadejte NumberStyles a CultureInfo.InvariantCulture. Obě metody vracejí false při neplatném zápisu čísla, ale neplatné argumenty stylu mohou vyvolat výjimky. Int32.TryParse vrací false i pro hodnoty mimo rozsah typu Int32. Naproti tomu Decimal.TryParse může hodnotu mírně vyšší než decimal.MaxValue zaokrouhlit dolů na decimal.MaxValue a vrátit true. To se děje například u 79228162514264337593543950335.1 při použití NumberStyles.Number a CultureInfo.InvariantCulture.

Řetězcový literál UTF-8 s příponou u8, například "OK"u8, je dostupný od C# 11 a vytváří ReadOnlySpan<byte>, nikoli string nebo ReadOnlySpan<char>. Jeho délka počítá bajty, ne znaky. Příklad cílí na net10.0 s LangVersion=preview, ale používá zavedené funkce, které režim preview nevyžadují.

Referenční identifikátory zahrnuté v tomto hesle: UTF-8 string literal u8.

Příklady

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

Výsledek

True
525.00
True

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje