CKTIS / C++
std::pmr::monotonic_buffer_resource — alocação com libertação em bloco
std::pmr::monotonic_buffer_resource fornece memória para alocações sucessivas, ignorando as desalocações individuais. release() devolve os blocos ao recurso a montante e reinicializa o recurso para reutilização.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <cstddef>
#include <memory_resource>
void use_resource(void* buffer, std::size_t buffer_size,
std::pmr::memory_resource* upstream) {
{
std::pmr::monotonic_buffer_resource resource;
}
{
std::pmr::monotonic_buffer_resource resource(buffer, buffer_size);
}
{
std::pmr::monotonic_buffer_resource resource(buffer, buffer_size, upstream);
resource.release();
}
}std::pmr::monotonic_buffer_resource, declarada em <memory_resource>, é um recurso de memória útil quando os objetos são criados gradualmente e a memória pode ser recuperada em conjunto. Os contentores PMR, como std::pmr::vector<int>, podem utilizá-la através de um alocador. As chamadas individuais de desalocação não recuperam espaço; o crescimento de um contentor pode, por isso, deixar blocos anteriores ocupados.
Pode fornecer um buffer inicial. Quando o espaço restante não satisfaz o tamanho e o alinhamento pedidos, o recurso obtém outro bloco do recurso a montante; os tamanhos dos blocos dependem da implementação. Se não for indicado explicitamente o argumento upstream, é utilizado o recurso de memória predefinido. Assim, o buffer inicial não constitui um limite rígido para o consumo de memória.
std::pmr::monotonic_buffer_resource::release() devolve todos os blocos obtidos ao recurso a montante e repõe o estado inicial das alocações, permitindo reutilizar o buffer fornecido. Não liberta o próprio buffer, que pertence ao chamador, nem invoca os destrutores dos objetos armazenados. Destrua primeiro os objetos e contentores que utilizam essas alocações; chamar apenas clear() num contentor não é suficiente, pois este pode manter a capacidade. O destrutor do recurso também chama release(). O buffer e o recurso a montante têm de permanecer disponíveis enquanto o recurso os utilizar.
O exemplo destrói o primeiro vetor antes de release() e, depois, cria um segundo com o mesmo recurso. Âmbito da entrada: C++23; a opção do compilador do repositório não atesta o ambiente de execução de produção. O documento ligado é um rascunho de trabalho em evolução, não uma publicação C++23 definitiva.
Exemplos
#include <cstddef>
#include <iostream>
#include <memory_resource>
#include <vector>
int main() {
alignas(std::max_align_t) std::byte buffer[256];
std::pmr::monotonic_buffer_resource resource(buffer, sizeof buffer);
{
std::pmr::vector<int> values(&resource);
values.reserve(3);
values.push_back(1);
values.push_back(2);
values.push_back(3);
std::cout << values[0] + values[1] + values[2] << '\n';
}
resource.release();
{
std::pmr::vector<int> values(&resource);
values.push_back(4);
std::cout << values.front() << '\n';
}
}
Resultado
6 4
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.