CKTIS / C#
Span a Memory: pohľady na buffery bez kopírovania
Span<T> a Memory<T> opisujú oblasti existujúcich bufferov bez kopírovania ich prvkov. Spoznajte obmedzenia ich životnosti, varianty iba na čítanie a spracovanie textu pomocou AsSpan, IndexOf, SequenceEqual a TryParse.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> je zapisovateľný pohľad na súvislú oblasť pamäte, zatiaľ čo ReadOnlySpan<T> umožňuje cez pohľad iba čítanie. Vytvorenie pohľadu ani jeho výrezu nekopíruje prvky. Samotný span je ref struct; jeho údaje môžu byť napríklad v poli na halde alebo v pamäti zásobníka. ReadOnly obmedzuje prístup cez pohľad, ale nezaručuje, že buffer nemožno upraviť inou cestou prístupu.
Memory<T> a ReadOnlyMemory<T> možno ukladať do polí tried a zachovať aj po await; ich vlastnosť .Span sprístupňuje pohľad na synchrónne spracovanie. Nie sú vlastníkmi buffera: nepoužívajte pohľad po vrátení buffera do poolu alebo po skončení povoleného obdobia jeho používania. Span nemožno zachytiť v lambda výraze ani uložiť do poľa triedy. Od C# 13 sú lokálne spany v metódach async povolené s obmedzeniami; nesmú prežiť await. Pred C# 13 boli v týchto metódach zakázané.
MemoryExtensions.AsSpan vytvorí pohľad; pre string vracia ReadOnlySpan<char> zložený z jednotiek kódu UTF-16. MemoryExtensions.IndexOf vracia prvý index počítaný od nuly alebo -1: pred vytvorením výrezu skontrolujte výsledok. MemoryExtensions.SequenceEqual porovnáva dĺžky a zodpovedajúce prvky, nie totožnosť pohľadov; pre char nevykonáva jazykové porovnávanie citlivé na kultúru.
Int32.TryParse(ReadOnlySpan<char>, ...) a Decimal.TryParse(ReadOnlySpan<char>, ...) spracujú výrez bez vytvorenia podreťazca. Skontrolujte vrátený bool; pre predvídateľný formát zadajte NumberStyles a CultureInfo.InvariantCulture. Obe metódy vracajú false pri neplatnom zápise čísla, ale neplatné argumenty štýlu môžu spôsobiť výnimky. Int32.TryParse vracia false aj pre hodnoty mimo rozsahu typu Int32. Naopak, Decimal.TryParse môže hodnotu mierne vyššiu ako decimal.MaxValue zaokrúhliť nadol na decimal.MaxValue a vrátiť true. Stáva sa to napríklad pri 79228162514264337593543950335.1 s použitím NumberStyles.Number a CultureInfo.InvariantCulture.
Reťazcový literál UTF-8 s príponou u8, napríklad "OK"u8, je dostupný od C# 11 a vytvára ReadOnlySpan<byte>, nie string ani ReadOnlySpan<char>. Jeho dĺžka počíta bajty, nie znaky. Príklad cieli na net10.0 s LangVersion=preview, ale používa zavedené funkcie, ktoré režim preview nevyžadujú.
Referenčné identifikátory zahrnuté v tomto hesle: UTF-8 string literal u8.
Prí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ýsledok
True 525.00 True
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.
Zdroje
- 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