Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

Span i Memory: pogledi na međuspremnike bez kopiranja

Span<T> i Memory<T> opisuju područja postojećih međuspremnika bez kopiranja njihovih elemenata. Upoznajte ograničenja trajanja, varijante samo za čitanje i obradu teksta pomoću AsSpan, IndexOf, SequenceEqual i TryParse.

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

Sintaksa

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

Span<T> je zapisiv pogled na neprekinuto područje memorije, dok ReadOnlySpan<T> putem pogleda omogućuje samo čitanje. Stvaranje pogleda ili njegova izreza ne kopira elemente. Span je sam po sebi ref struct; njegovi se podaci mogu nalaziti, primjerice, u polju na hrpi ili u memoriji stoga. ReadOnly ograničava pristup putem pogleda, ali ne jamči da se međuspremnik ne može izmijeniti drugim putem pristupa.

Memory<T> i ReadOnlyMemory<T> mogu se pohraniti u polja klasa i zadržati nakon await; njihovo svojstvo .Span omogućuje pogled za sinkronu obradu. Ne posjeduju međuspremnik: nemojte koristiti pogled nakon što je međuspremnik vraćen u skup ili nakon isteka dopuštenog razdoblja uporabe. Span se ne može obuhvatiti lambdom niti pohraniti u polje klase. Od C# 13 lokalni su spanovi dopušteni u metodama async uz ograničenja; ne smiju nadživjeti await. Prije C# 13 bili su zabranjeni u tim metodama.

MemoryExtensions.AsSpan stvara pogled; za string vraća ReadOnlySpan<char> UTF-16 kodnih jedinica. MemoryExtensions.IndexOf vraća prvi indeks koji počinje od nule ili -1: provjerite rezultat prije izrezivanja. MemoryExtensions.SequenceEqual uspoređuje duljine i odgovarajuće elemente, a ne identitet pogleda; za char ne provodi jezičnu usporedbu ovisnu o kulturi.

Int32.TryParse(ReadOnlySpan<char>, ...) i Decimal.TryParse(ReadOnlySpan<char>, ...) obrađuju izrez bez stvaranja podniza. Provjerite vraćeni bool; navedite NumberStyles i CultureInfo.InvariantCulture za predvidljiv format. Obje metode vraćaju false ako zapis broja nije valjan, ali neispravni argumenti stila mogu uzrokovati iznimke. Int32.TryParse vraća false i za vrijednosti izvan raspona tipa Int32. Nasuprot tome, Decimal.TryParse može vrijednost malo veću od decimal.MaxValue zaokružiti naniže na decimal.MaxValue i vratiti true. To se, primjerice, događa za 79228162514264337593543950335.1 uz NumberStyles.Number i CultureInfo.InvariantCulture.

UTF-8 znakovni literal sa sufiksom u8, primjerice "OK"u8, dostupan je od C# 11 i daje ReadOnlySpan<byte>, a ne string ili ReadOnlySpan<char>. Njegova duljina broji bajtove, a ne znakove. Primjer cilja na net10.0 uz LangVersion=preview, ali koristi ustaljene značajke koje ne zahtijevaju preview način rada.

Referentni identifikatori obuhvaćeni ovim unosom: UTF-8 string literal u8.

Primjeri

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

Rezultat

True
525.00
True

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori