CKTIS / C#
IMemoryOwner<T> — vlasništvo nad memorijskim međuspremnikom
IMemoryOwner<T> izražava odgovornost za životni vijek međuspremnika. Svojstvo Memory izlaže njegov sadržaj kao Memory<T>, dok naslijeđeni Dispose završava vlasnikovo korištenje resursa.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public interface IMemoryOwner<T> : IDisposable
{
Memory<T> Memory { get; }
}IMemoryOwner<T> u prostoru naziva System.Buffers predstavlja vlasnika međuspremnika s elementima tipa T. Dostupan je u .NET 10. Međuspremnik u određenom trenutku ima jednog vlasnika, ali može imati više korisnika. Vlasništvo znači odgovornost za životni vijek resursa, a ne isključiv pristup njegovim podacima.
Svojstvo IMemoryOwner<T>.Memory tipa je Memory<T> i ima samo pristupnik get. To ipak ne čini elemente nepromjenjivima: mogu se mijenjati putem owner.Memory.Span. Prosljeđivanje prikaza Memory<T> drugom kodu samo po sebi ne prenosi vlasništvo niti produljuje životni vijek međuspremnika.
Sučelje nasljeđuje IDisposable.Dispose. Pozovite Dispose() tek kada svi korisnici, uključujući asinkrone operacije, završe; nakon toga nemojte koristiti međuspremnik ni spremljene prikaze. Implementacija može, primjerice, vratiti memoriju u memorijski bazen. Nakon prijenosa vlasništva prethodni vlasnik ne bi trebao koristiti ni osloboditi međuspremnik; za to je odgovoran novi vlasnik.
Primjer koristi MemoryPool<int>.Shared.Rent(3), koji osigurava najmanje tri elementa, ne nužno točno tri. Slice(0, 3) odabire dio koji se koristi, a kod zapisuje svaki element koji čita. Blok using poziva Dispose() čak i ako dođe do iznimke. Očekivani izlaz je 60.
Primjeri
using System;
using System.Buffers;
internal static class Program
{
private static void Main()
{
using (IMemoryOwner<int> owner = MemoryPool<int>.Shared.Rent(3))
{
Memory<int> memory = owner.Memory.Slice(0, 3);
Span<int> span = memory.Span;
span[0] = 10;
span[1] = 20;
span[2] = 30;
Console.WriteLine(span[0] + span[1] + span[2]);
}
}
}Rezultat
60
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.