CKTIS / C++
std::pmr::unsynchronized_pool_resource — Speicherpools ohne Synchronisierung
std::pmr::unsynchronized_pool_resource verwaltet Pools von Speicherblöcken für polymorphe Allokatoren. Freigegebene Blöcke können wiederverwendet werden; dafür müssen Ressourcenlebensdauer und der Ausschluss gleichzeitiger Zugriffe aus mehreren Threads sorgfältig beachtet werden.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <memory_resource>
std::pmr::unsynchronized_pool_resource pool;
std::pmr::unsynchronized_pool_resource pool_with_upstream{upstream};
std::pmr::unsynchronized_pool_resource configured_pool{options, upstream};std::pmr::unsynchronized_pool_resource aus <memory_resource> ist eine von std::pmr::memory_resource abgeleitete Speicherressource. Sie verwaltet Pools mit Blöcken unterschiedlicher Größe. Ist ein Pool erschöpft, bezieht sie einen weiteren Speicherbereich von der übergeordneten Ressource (upstream); Anforderungen, die die größte unterstützte Poolgröße überschreiten, gehen direkt an diese Ressource. Freigegebene Blöcke können für spätere Allokationen verwendet werden.
Der Standardkonstruktor verwendet std::pmr::get_default_resource(). Alternativ können ein Zeiger auf eine gültige übergeordnete Ressource und std::pmr::pool_options übergeben werden. Der Pool besitzt die übergeordnete Ressource nicht: Diese muss länger leben als der Pool. options() gibt die tatsächlich verwendeten Einstellungen zurück, die von den angeforderten abweichen können; Blockgrößen und Anzahl der Allokationen sind keine portablen Garantien.
Greifen Sie nicht gleichzeitig von mehreren Threads auf dieselbe Ressource zu. Sorgen Sie für externe Synchronisierung oder verwenden Sie std::pmr::synchronized_pool_resource. Die Synchronisierung der Ressource macht gleichzeitige Änderungen an einem Container, der sie verwendet, jedoch nicht sicher.
release() gibt den gesamten zugewiesenen Speicher an die übergeordnete Ressource zurück, auch Blöcke, die Clients noch nicht zurückgegeben haben; der Destruktor erledigt dies automatisch. Dadurch werden Aufrufe von Objekt-Destruktoren nicht ersetzt. Zerstören Sie Container und Objekte, die den Speicher verwenden, bevor Sie release() aufrufen oder den Pool zerstören. Im Beispiel stellt der verschachtelte Gültigkeitsbereich diese Reihenfolge für std::pmr::vector<int> sicher.
Beispiele
#include <iostream>
#include <memory_resource>
#include <vector>
int main() {
std::pmr::unsynchronized_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 << values.size() << ' ' << sum << '\n';
}
pool.release();
}
Ergebnis
3 60
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.