CKTIS / C#
Span i Memory: widoki na bufory bez kopiowania
Span<T> i Memory<T> opisują fragmenty istniejących buforów bez kopiowania ich elementów. Poznaj ograniczenia czasu życia, warianty tylko do odczytu oraz przetwarzanie tekstu przez AsSpan, IndexOf, SequenceEqual i TryParse.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
Span<T>; ReadOnlySpan<T>; Memory<T>; ReadOnlyMemory<T>; text.AsSpan(); span[start..end]; memory.Span; "text"u8Span<T> jest zapisywalnym widokiem na ciągły obszar pamięci, a ReadOnlySpan<T> pozwala jedynie go odczytywać. Widok i jego wycinki nie kopiują elementów. Sam span jest typem ref struct; dane mogą znajdować się m.in. w tablicy na stercie lub w pamięci stosu. ReadOnly ogranicza dostęp przez widok, ale nie gwarantuje niezmienności bufora modyfikowanego inną drogą.
Memory<T> i ReadOnlyMemory<T> można przechowywać w polach klas oraz zachować przez await; właściwość .Span udostępnia widok do pracy synchronicznej. Nie są właścicielami bufora: nie wolno korzystać z widoku po zwrocie bufora do puli lub zakończeniu jego dozwolonego czasu użytkowania. Spanu nie można przechwycić w lambdzie ani umieścić w polu klasy. Od C# 13 lokalne spany są dozwolone w metodach async z ograniczeniami; nie mogą przetrwać await. Przed C# 13 były w takich metodach zabronione.
MemoryExtensions.AsSpan tworzy widok; dla string jest to ReadOnlySpan<char> jednostek UTF-16. MemoryExtensions.IndexOf zwraca pierwszy indeks liczony od zera albo -1: sprawdź wynik przed wycinaniem. MemoryExtensions.SequenceEqual porównuje długość i odpowiadające sobie elementy, nie tożsamość widoków; dla char nie wykonuje porównania językowego zależnego od kultury.
Int32.TryParse(ReadOnlySpan<char>, ...) i Decimal.TryParse(ReadOnlySpan<char>, ...) przetwarzają wycinek bez tworzenia podłańcucha. Sprawdzaj zwracany bool; dla przewidywalnego formatu podaj NumberStyles i CultureInfo.InvariantCulture. Obie metody zwracają false dla nieprawidłowego tekstu liczbowego, ale nieprawidłowe argumenty stylu mogą powodować wyjątki. Int32.TryParse zwraca false również dla wartości spoza zakresu Int32. Natomiast Decimal.TryParse może zaokrąglić wartość nieco większą niż decimal.MaxValue w dół do decimal.MaxValue i zwrócić true. Tak dzieje się na przykład dla 79228162514264337593543950335.1 przy użyciu NumberStyles.Number i CultureInfo.InvariantCulture.
Literał UTF-8 z sufiksem u8, np. "OK"u8, jest dostępny od C# 11 i daje ReadOnlySpan<byte>, nie string ani ReadOnlySpan<char>. Jego długość liczy bajty, nie znaki. Przykład dla net10.0 z LangVersion=preview korzysta z istniejących funkcji, a nie z funkcji wymagających trybu preview.
Identyfikatory objęte tym wpisem: UTF-8 string literal u8.
Przykłady
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));Wynik
True 525.00 True
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.
Źródła
- 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