Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::pmr::synchronized_pool_resource — pool di memoria sincronizzati

std::pmr::synchronized_pool_resource gestisce pool di blocchi di memoria e supporta l’accesso concorrente da più thread. Può fornire memoria ai contenitori PMR, ma la sincronizzazione della risorsa non rende sicure le modifiche concorrenti al contenitore stesso.

Versione: C++23; repository compiler flag, production runtime not attested

Sintassi

#include <memory_resource>

std::pmr::synchronized_pool_resource pool;
std::pmr::synchronized_pool_resource configured(options, upstream);

std::pmr::synchronized_pool_resource, dichiarata in <memory_resource>, è una risorsa di memoria che gestisce pool di blocchi di dimensioni diverse. Ottiene porzioni più grandi da una risorsa a monte (upstream) e le suddivide in blocchi. Le richieste che superano la dimensione massima gestita dai pool vengono inoltrate direttamente a upstream.

Più thread possono accedere a questa risorsa senza sincronizzazione esterna. Questo, però, non significa che un contenitore condiviso che la usa possa essere modificato contemporaneamente senza restrizioni. Al contrario, std::pmr::unsynchronized_pool_resource non consente l’accesso simultaneo da più thread.

Il costruttore predefinito sceglie std::pmr::get_default_resource() come risorsa a monte. Un altro costruttore accetta std::pmr::pool_options e un puntatore a upstream; la risorsa non ne acquisisce la proprietà. max_blocks_per_chunk e largest_required_pool_block regolano i pool, ma l’implementazione può modificarne i valori. options() restituisce le impostazioni in uso.

La risorsa deve rimanere in vita più a lungo dei contenitori che la usano e upstream deve restare valido durante il suo utilizzo. release() restituisce tutta la memoria allocata, compresi i blocchi ancora in uso, senza chiamare i distruttori degli oggetti memorizzati. Distruggi oggetti e contenitori prima di chiamare release(). Anche il distruttore della risorsa libera la memoria.

L’esempio crea un std::pmr::vector<int> che usa il pool e stampa la somma dei suoi elementi. L’ambito interno distrugge il vettore prima di release(). Non presuppone né un numero preciso di allocazioni né il riutilizzo di un indirizzo specifico.

Esempi

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

Risultato

60

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti