CKTIS / C#
Span en Memory: bufferviews zonder kopiëren
Span<T> en Memory<T> beschrijven gebieden van bestaande buffers zonder de elementen te kopiëren. Leer over de beperkingen van hun levensduur, de alleen-lezenvarianten en tekstverwerking met AsSpan, IndexOf, SequenceEqual en TryParse.
Versie: .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> is een schrijfbare weergave van een aaneengesloten geheugengebied, terwijl ReadOnlySpan<T> via de weergave alleen lezen toestaat. Het maken of uitsnijden van een weergave kopieert geen elementen. Een span is zelf een ref struct; de gegevens kunnen zich bijvoorbeeld in een heap-array of in stackgeheugen bevinden. ReadOnly beperkt de toegang via de weergave, maar garandeert niet dat de buffer niet via een andere toegangsroute kan worden gewijzigd.
Memory<T> en ReadOnlyMemory<T> kunnen in klassevelden worden opgeslagen en na een await behouden blijven; hun eigenschap .Span geeft een weergave voor synchrone verwerking. Ze zijn geen eigenaar van de buffer: gebruik een weergave niet meer nadat de buffer aan een pool is teruggegeven of de toegestane gebruiksperiode is verstreken. Een span kan niet in een lambda worden vastgelegd of in een klasseveld worden opgeslagen. Sinds C# 13 zijn lokale spans met beperkingen toegestaan in async-methoden; ze mogen een await niet overleven. Vóór C# 13 waren ze in deze methoden verboden.
MemoryExtensions.AsSpan maakt een weergave; voor een string retourneert het een ReadOnlySpan<char> van UTF-16-code-eenheden. MemoryExtensions.IndexOf retourneert de eerste index vanaf nul of -1: controleer het resultaat voordat je een uitsnede maakt. MemoryExtensions.SequenceEqual vergelijkt lengtes en overeenkomstige elementen, niet de identiteit van weergaven; voor char voert het geen cultuurgevoelige taalkundige vergelijking uit.
Int32.TryParse(ReadOnlySpan<char>, ...) en Decimal.TryParse(ReadOnlySpan<char>, ...) verwerken een segment zonder een substring te maken. Controleer de geretourneerde bool; geef NumberStyles en CultureInfo.InvariantCulture op voor een voorspelbaar formaat. Beide methoden geven false terug als de tekst geen geldige getalnotatie bevat, maar ongeldige stijlargumenten kunnen uitzonderingen veroorzaken. Int32.TryParse geeft ook false terug voor waarden buiten het bereik van Int32. Decimal.TryParse kan daarentegen een waarde net boven decimal.MaxValue naar beneden afronden tot decimal.MaxValue en true teruggeven. Dat gebeurt bijvoorbeeld bij 79228162514264337593543950335.1 met NumberStyles.Number en CultureInfo.InvariantCulture.
Een UTF-8-stringliteral met het achtervoegsel u8, zoals "OK"u8, is beschikbaar sinds C# 11 en levert een ReadOnlySpan<byte> op, geen string of ReadOnlySpan<char>. De lengte telt bytes, geen tekens. Het voorbeeld richt zich op net10.0 met LangVersion=preview, maar gebruikt gevestigde functies waarvoor de previewmodus niet nodig is.
Referentie-identificatoren die in dit item worden behandeld: UTF-8 string literal u8.
Voorbeelden
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));Resultaat
True 525.00 True
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.
Bronnen
- 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