Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje