CKTIS / C++
std::pmr::synchronized_pool_resource — synchronizované paměťové pooly
std::pmr::synchronized_pool_resource spravuje pooly paměťových bloků a podporuje souběžný přístup z více vláken. Může poskytovat úložiště kontejnerům PMR, synchronizace zdroje však nezajišťuje bezpečné souběžné úpravy samotného kontejneru.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <memory_resource>
std::pmr::synchronized_pool_resource pool;
std::pmr::synchronized_pool_resource configured(options, upstream);std::pmr::synchronized_pool_resource z hlavičky <memory_resource> je paměťový zdroj spravující pooly bloků různých velikostí. Získává větší části paměti z nadřazeného zdroje (upstream) a dělí je na bloky. Požadavky přesahující největší velikost obsluhovanou pooly předává přímo upstream.
K tomuto zdroji může přistupovat více vláken bez vnější synchronizace. Neznamená to však, že lze sdílený kontejner, který jej používá, bez omezení souběžně měnit. Naproti tomu std::pmr::unsynchronized_pool_resource souběžný přístup z více vláken neumožňuje.
Výchozí konstruktor zvolí jako upstream std::pmr::get_default_resource(). Jiný konstruktor přijímá std::pmr::pool_options a ukazatel na upstream; zdroj nepřebírá vlastnictví upstream. max_blocks_per_chunk a largest_required_pool_block nastavují pooly, jejich hodnoty však může implementace upravit. options() vrací používané nastavení.
Zdroj musí existovat déle než kontejnery, které jej používají, a upstream musí zůstat platný po dobu jeho používání. release() vrátí veškerou přidělenou paměť, včetně dosud nevrácených bloků, aniž zavolá destruktory uložených objektů. Před voláním release() zničte objekty a kontejnery. Destruktor zdroje také uvolní jeho paměť.
Příklad vytvoří std::pmr::vector<int> využívající pool a vypíše součet jeho prvků. Vnitřní rozsah platnosti zničí vektor před voláním release(). Příklad nepředpokládá konkrétní počet alokací ani opětovné použití určité adresy.
Příklady
#include <iostream>
#include <memory_resource>
#include <vector>
int main() {
std::pmr::synchronized_pool_resource pool;
{
std::pmr::vector<int> values{&pool};
values.reserve(3);
values.push_back(10);
values.push_back(20);
values.push_back(30);
int sum = 0;
for (int value : values) {
sum += value;
}
std::cout << sum << '\n';
}
pool.release();
}
Výsledek
60
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.