CKTIS / C++
std::pmr::monotonic_buffer_resource — asignación con liberación en bloque
std::pmr::monotonic_buffer_resource proporciona almacenamiento para asignaciones sucesivas e ignora las desasignaciones individuales. release() devuelve los bloques al recurso ascendente y restablece el recurso para volver a usarlo.
Versión: C++23; repository compiler flag, production runtime not attested
Sintaxis
#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 en <memory_resource>, es un recurso de memoria útil cuando los objetos se crean progresivamente y el almacenamiento se puede recuperar en conjunto. Los contenedores PMR, como std::pmr::vector<int>, pueden usarlo mediante un asignador. Las llamadas individuales de desasignación no recuperan espacio, por lo que el crecimiento de un contenedor puede dejar ocupados los bloques anteriores.
Se puede proporcionar un búfer inicial. Si el espacio restante no satisface el tamaño y la alineación solicitados, el recurso obtiene otro bloque de su recurso ascendente; el tamaño de los bloques depende de la implementación. Si no se especifica el argumento upstream, se usa el recurso de memoria predeterminado. Por tanto, el búfer inicial no es un límite estricto para el consumo de memoria.
std::pmr::monotonic_buffer_resource::release() devuelve todos los bloques obtenidos al recurso ascendente y restaura el estado inicial de asignación, lo que permite reutilizar el búfer proporcionado. No libera el propio búfer propiedad del llamador ni invoca los destructores de los objetos almacenados. Destruye primero los objetos y contenedores que usan esas asignaciones; llamar únicamente a clear() en un contenedor no basta, porque puede conservar su capacidad. El destructor del recurso también llama a release(). El búfer y el recurso ascendente deben seguir disponibles mientras el recurso los utilice.
El ejemplo destruye el primer vector antes de release() y después crea un segundo con el mismo recurso. Alcance de la entrada: C++23; la opción del compilador del repositorio no acredita el entorno de ejecución de producción. El documento enlazado es un borrador de trabajo en evolución, no una publicación definitiva de C++23.
Ejemplos
#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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.