CKTIS / C++
std::pmr::monotonic_buffer_resource — Allokation mit gebündelter Freigabe
std::pmr::monotonic_buffer_resource stellt Speicher für aufeinanderfolgende Allokationen bereit und ignoriert einzelne Deallokationen. release() gibt Blöcke an die übergeordnete Ressource zurück und setzt die Ressource zur Wiederverwendung zurück.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#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 aus <memory_resource> ist eine Speicherressource für Situationen, in denen Objekte schrittweise entstehen und der Speicher gemeinsam zurückgewonnen werden kann. PMR-Container wie std::pmr::vector<int> können sie über einen Allocator verwenden. Einzelne Deallokationen geben keinen Speicher zurück; beim Wachstum eines Containers können frühere Blöcke daher belegt bleiben.
Ein eigener Anfangspuffer kann übergeben werden. Reicht der verbleibende Platz für die angeforderte Größe und Ausrichtung nicht aus, fordert die Ressource einen weiteren Block von ihrer übergeordneten Ressource an; die Blockgrößen sind implementierungsabhängig. Ohne ein explizites Argument upstream wird die Standard-Speicherressource verwendet. Der Anfangspuffer ist daher keine feste Grenze für den Speicherverbrauch.
std::pmr::monotonic_buffer_resource::release() gibt alle von der übergeordneten Ressource bezogenen Blöcke an diese zurück und stellt den anfänglichen Allokationszustand wieder her, sodass der bereitgestellte Puffer erneut verwendet werden kann. Die Funktion gibt weder den vom Aufrufer bereitgestellten Puffer selbst frei noch ruft sie Destruktoren gespeicherter Objekte auf. Zerstöre zuerst Objekte und Container, die diese Allokationen verwenden; ein bloßer Aufruf von clear() reicht nicht aus, da ein Container seine Kapazität behalten kann. Auch der Destruktor der Ressource ruft release() auf. Puffer und übergeordnete Ressource müssen verfügbar bleiben, solange die Ressource sie verwendet.
Das Beispiel zerstört den ersten Vektor vor release() und erstellt anschließend einen zweiten mit derselben Ressource. Geltungsbereich des Eintrags: C++23; das Compiler-Flag des Repositorys bestätigt nicht die Produktionslaufzeitumgebung. Das verlinkte Dokument ist ein fortlaufend bearbeiteter Entwurf und keine eingefrorene C++23-Veröffentlichung.
Beispiele
#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';
}
}
Ergebnis
6 4
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.