WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::pmr::synchronized_pool_resource — synchronisierte Speicherpools

std::pmr::synchronized_pool_resource verwaltet Pools aus Speicherblöcken und unterstützt den gleichzeitigen Zugriff durch mehrere Threads. Er kann PMR-Containern Speicher bereitstellen; die Synchronisierung der Ressource macht gleichzeitige Änderungen am Container selbst jedoch nicht sicher.

Version: 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 aus dem Header <memory_resource> ist eine Speicherressource, die Pools unterschiedlich großer Blöcke verwaltet. Sie bezieht größere Speicherbereiche von einer Upstream-Ressource und teilt sie in Blöcke auf. Anforderungen, die die größte von den Pools verwaltete Größe überschreiten, werden direkt an Upstream weitergeleitet.

Mehrere Threads können ohne externe Synchronisierung auf diese Ressource zugreifen. Das bedeutet jedoch nicht, dass ein gemeinsam genutzter Container, der sie verwendet, uneingeschränkt gleichzeitig geändert werden kann. Im Gegensatz dazu erlaubt std::pmr::unsynchronized_pool_resource keinen gleichzeitigen Zugriff durch mehrere Threads.

Der Standardkonstruktor wählt std::pmr::get_default_resource() als Upstream-Ressource. Ein anderer Konstruktor nimmt std::pmr::pool_options und einen Upstream-Zeiger entgegen; die Ressource übernimmt nicht das Eigentum an Upstream. max_blocks_per_chunk und largest_required_pool_block steuern die Poolbildung, ihre Werte können jedoch von der Implementierung angepasst werden. options() gibt die verwendeten Einstellungen zurück.

Die Ressource muss länger leben als die sie verwendenden Container, und Upstream muss während ihrer Verwendung gültig bleiben. release() gibt den gesamten zugewiesenen Speicher zurück, einschließlich noch ausstehender Blöcke, ohne die Destruktoren der gespeicherten Objekte aufzurufen. Zerstöre Objekte und Container, bevor du release() aufrufst. Auch der Destruktor der Ressource gibt ihren Speicher frei.

Das Beispiel erstellt einen von dem Pool gestützten std::pmr::vector<int> und gibt die Summe seiner Elemente aus. Der innere Gültigkeitsbereich zerstört den Vektor vor release(). Das Beispiel setzt weder eine bestimmte Anzahl von Speicherzuweisungen noch die Wiederverwendung einer bestimmten Adresse voraus.

Beispiele

#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();
}

Ergebnis

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.

Quellen