Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::pmr::unsynchronized_pool_resource — pools de memória sem sincronização

std::pmr::unsynchronized_pool_resource gere pools de blocos de memória para alocadores polimórficos. Permite reutilizar blocos libertados, mas quem o utiliza tem de gerir o tempo de vida dos recursos e impedir o acesso simultâneo a partir de várias threads.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#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, declarado em <memory_resource>, é um recurso de memória derivado de std::pmr::memory_resource. Mantém pools de blocos de diferentes dimensões. Quando um pool se esgota, obtém outro bloco de memória do recurso a montante (upstream); os pedidos que excedem a maior dimensão de pool suportada são encaminhados diretamente para esse recurso. Os blocos libertados podem ser usados em alocações posteriores.

O construtor predefinido utiliza std::pmr::get_default_resource(). Em alternativa, pode fornecer um ponteiro para um recurso a montante válido e std::pmr::pool_options. O pool não é proprietário do recurso a montante: este tem de durar mais do que o pool. options() devolve as definições efetivas, que podem diferir das pedidas; as dimensões dos blocos e o número de alocações não são garantias portáveis.

Não aceda simultaneamente ao mesmo recurso a partir de várias threads. Garanta sincronização externa ou utilize std::pmr::synchronized_pool_resource. No entanto, a sincronização do recurso não torna seguras as modificações simultâneas de um contentor que o utilize.

release() devolve ao recurso a montante toda a memória alocada, incluindo os blocos ainda não devolvidos pelos clientes; a destruição faz isso automaticamente. Isto não substitui as chamadas aos destrutores dos objetos. Destrua os contentores e objetos que utilizam a memória antes de chamar release() ou destruir o pool. No exemplo, o âmbito aninhado estabelece esta ordem para std::pmr::vector<int>.

Exemplos

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

Resultado

3 60

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes