CKTIS / C++
std::pmr::monotonic_buffer_resource — alokácia s hromadným uvoľnením
std::pmr::monotonic_buffer_resource poskytuje pamäť na postupné alokácie a ignoruje jednotlivé dealokácie. release() vráti bloky nadradenému zdroju a resetuje zdroj na opätovné použitie.
Verzia: C++23; repository compiler flag, production runtime not attested
Syntax
#include <cstddef>
#include <memory_resource>
void use_resource(void* buffer, std::size_t buffer_size,
std::pmr::memory_resource* upstream) {
{
std::pmr::monotonic_buffer_resource resource;
}
{
std::pmr::monotonic_buffer_resource resource(buffer, buffer_size);
}
{
std::pmr::monotonic_buffer_resource resource(buffer, buffer_size, upstream);
resource.release();
}
}std::pmr::monotonic_buffer_resource z hlavičky <memory_resource> je pamäťový zdroj vhodný vtedy, keď objekty vznikajú postupne a pamäť možno získať späť naraz. Kontajnery PMR, napríklad std::pmr::vector<int>, ho môžu používať prostredníctvom alokátora. Jednotlivé volania dealokácie neuvoľňujú žiadne miesto, takže pri raste kontajnera môžu predchádzajúce bloky zostať obsadené.
Možno zadať vlastný počiatočný buffer. Ak zostávajúce miesto nevyhovuje požadovanej veľkosti a zarovnaniu, zdroj získa ďalší blok od nadradeného zdroja; veľkosti blokov závisia od implementácie. Bez explicitného argumentu upstream sa použije predvolený pamäťový zdroj. Počiatočný buffer preto nie je pevnou hranicou spotreby pamäte.
std::pmr::monotonic_buffer_resource::release() vráti všetky získané bloky nadradenému zdroju a obnoví počiatočný stav alokácií, takže dodaný buffer možno použiť znova. Neuvoľní samotný buffer vo vlastníctve volajúceho ani nezavolá deštruktory uložených objektov. Najprv zničte objekty a kontajnery, ktoré tieto alokácie používajú; samotné zavolanie clear() na kontajner nestačí, pretože si môže ponechať kapacitu. Deštruktor zdroja tiež volá release(). Buffer aj nadradený zdroj musia zostať dostupné, kým ich zdroj používa.
Príklad zničí prvý vektor pred volaním release() a potom vytvorí druhý s použitím toho istého zdroja. Rozsah záznamu: C++23; príznak kompilátora v repozitári nepotvrdzuje produkčné behové prostredie. Prepojený dokument je priebežne upravovaný pracovný návrh, nie zmrazené vydanie C++23.
Príklady
#include <cstddef>
#include <iostream>
#include <memory_resource>
#include <vector>
int main() {
alignas(std::max_align_t) std::byte buffer[256];
std::pmr::monotonic_buffer_resource resource(buffer, sizeof buffer);
{
std::pmr::vector<int> values(&resource);
values.reserve(3);
values.push_back(1);
values.push_back(2);
values.push_back(3);
std::cout << values[0] + values[1] + values[2] << '\n';
}
resource.release();
{
std::pmr::vector<int> values(&resource);
values.push_back(4);
std::cout << values.front() << '\n';
}
}
Výsledok
6 4
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.