CKTIS / C++
std::pmr::synchronized_pool_resource — gesynchroniseerde geheugenpools
std::pmr::synchronized_pool_resource beheert pools van geheugenblokken en ondersteunt gelijktijdige toegang vanuit meerdere threads. De resource kan geheugen leveren aan PMR-containers, maar de synchronisatie ervan maakt gelijktijdige wijzigingen aan een container zelf niet veilig.
Versie: C++23; repository compiler flag, production runtime not attested
Syntax
#include <memory_resource>
std::pmr::synchronized_pool_resource pool;
std::pmr::synchronized_pool_resource configured(options, upstream);std::pmr::synchronized_pool_resource, gedeclareerd in <memory_resource>, is een geheugenresource die pools met blokken van verschillende groottes beheert. De resource haalt grotere geheugendelen op bij een upstream-resource en verdeelt die in blokken. Verzoeken die groter zijn dan de grootste grootte die de pools afhandelen, worden rechtstreeks naar upstream doorgestuurd.
Meerdere threads kunnen deze resource zonder externe synchronisatie gebruiken. Dat betekent niet dat een gedeelde container die de resource gebruikt zonder beperkingen gelijktijdig kan worden gewijzigd. std::pmr::unsynchronized_pool_resource staat daarentegen geen gelijktijdige toegang vanuit meerdere threads toe.
De standaardconstructor kiest std::pmr::get_default_resource() als upstream. Een andere constructor accepteert std::pmr::pool_options en een pointer naar upstream; de resource neemt het eigendom van upstream niet over. max_blocks_per_chunk en largest_required_pool_block regelen de pools, maar de implementatie kan de waarden aanpassen. options() geeft de gebruikte instellingen terug.
De resource moet langer bestaan dan de containers die ervan gebruikmaken, en upstream moet geldig blijven zolang de resource wordt gebruikt. release() geeft al het toegewezen geheugen terug, ook nog in gebruik zijnde blokken, zonder de destructors van opgeslagen objecten aan te roepen. Vernietig objecten en containers voordat je release() aanroept. De destructor van de resource geeft het geheugen ook vrij.
Het voorbeeld maakt een door de pool ondersteunde std::pmr::vector<int> en drukt de som van de elementen af. Het binnenste bereik vernietigt de vector vóór release(). Het gaat niet uit van een bepaald aantal toewijzingen of van hergebruik van een specifiek adres.
Voorbeelden
#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();
}
Resultaat
60
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.