Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C#

Span in Memory: pogledi na medpomnilnike brez kopiranja

Span<T> in Memory<T> opisujeta območja obstoječih medpomnilnikov, ne da bi kopirala njihove elemente. Spoznajte omejitve življenjske dobe, različice samo za branje in obdelavo besedila z AsSpan, IndexOf, SequenceEqual in TryParse.

Različica: .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 zapisljiv pogled na zvezno območje pomnilnika, medtem ko ReadOnlySpan<T> prek pogleda omogoča samo branje. Ustvarjanje pogleda ali njegovega izreza ne kopira elementov. Span je sam po sebi ref struct; njegovi podatki so lahko na primer v polju na kopici ali v pomnilniku sklada. ReadOnly omejuje dostop prek pogleda, vendar ne zagotavlja, da medpomnilnika ni mogoče spremeniti po drugi dostopni poti.

Memory<T> in ReadOnlyMemory<T> lahko shranite v polja razredov in ohranite prek await; njuna lastnost .Span omogoča pogled za sinhrono obdelavo. Medpomnilnika ne posedujeta: pogleda ne uporabljajte, ko je bil medpomnilnik vrnjen v skupino ali se je izteklo dovoljeno obdobje uporabe. Spana ni mogoče zajeti v lambdi ali shraniti v polje razreda. Od C# 13 so lokalni spani z omejitvami dovoljeni v metodah async; ne smejo preživeti await. Pred C# 13 so bili v teh metodah prepovedani.

MemoryExtensions.AsSpan ustvari pogled; za string vrne ReadOnlySpan<char> enot kode UTF-16. MemoryExtensions.IndexOf vrne prvi indeks, štet od nič, ali -1: pred izrezom preverite rezultat. MemoryExtensions.SequenceEqual primerja dolžine in ustrezne elemente, ne pa istovetnosti pogledov; za char ne izvaja jezikovne primerjave, občutljive na kulturo.

Int32.TryParse(ReadOnlySpan<char>, ...) in Decimal.TryParse(ReadOnlySpan<char>, ...) obdelata izsek, ne da bi ustvarila podniz. Preverite vrnjeni bool; za predvidljivo obliko navedite NumberStyles in CultureInfo.InvariantCulture. Obe metodi vrneta false pri neveljavnem zapisu števila, neveljavni argumenti sloga pa lahko povzročijo izjeme. Int32.TryParse vrne false tudi za vrednosti zunaj obsega tipa Int32. Nasprotno pa lahko Decimal.TryParse vrednost, ki je nekoliko večja od decimal.MaxValue, zaokroži navzdol na decimal.MaxValue in vrne true. To se na primer zgodi pri 79228162514264337593543950335.1 z uporabo NumberStyles.Number in CultureInfo.InvariantCulture.

Dobesedni niz UTF-8 s pripono u8, na primer "OK"u8, je na voljo od C# 11 in ustvari ReadOnlySpan<byte>, ne pa string ali ReadOnlySpan<char>. Njegova dolžina šteje bajte, ne znakov. Primer cilja na net10.0 z LangVersion=preview, vendar uporablja uveljavljene funkcije, ki ne zahtevajo načina preview.

Referenčni identifikatorji, zajeti v tem geslu: UTF-8 string literal u8.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri