CKTIS / C++
std::pmr::memory_resource — polymorphe Speicherressource
std::pmr::memory_resource ist eine abstrakte Schnittstelle zum Allozieren und Freigeben von Speicher mit einer angegebenen Ausrichtung. Sie ermöglicht die Laufzeitwahl einer Allokationsstrategie; std::pmr::polymorphic_allocator verbindet diese Schnittstelle mit Code, der einen Allocator erwartet.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <memory_resource>
std::pmr::memory_resource* resource = std::pmr::new_delete_resource();
void* p = resource->allocate(bytes, alignment);
resource->deallocate(p, bytes, alignment);std::pmr::memory_resource, deklariert in <memory_resource>, steht für eine Speicherressource, nicht für einen typisierten Allocator oder Container. Sie kann nicht direkt instanziiert werden. std::pmr::polymorphic_allocator<T> verwendet eine zur Laufzeit ausgewählte Ressource, ohne seinen statischen Typ zu ändern; er speichert einen Zeiger auf die Ressource, übernimmt aber nicht deren Besitz. Die Ressource muss während der Operationen verfügbar bleiben, die sie verwenden.
allocate(bytes, alignment) alloziert mindestens bytes Bytes mit der angeforderten Ausrichtung; alignment muss eine Zweierpotenz sein und ist standardmäßig alignof(std::max_align_t). Dies ist keine allgemeine Operation zum Aufrufen von Konstruktoren benutzerdefinierter Objekte. Ein Allokationsfehler wird durch eine Ausnahme gemeldet. deallocate(p, bytes, alignment) erfordert dieselbe Größe und Ausrichtung sowie einen Block, der noch nicht freigegeben wurde und über eine gleichwertige Ressource alloziert wurde. Die Funktion ruft keine Destruktoren von Objekten auf und darf keine Ausnahmen auslösen.
Die öffentlichen Funktionen delegieren an die privaten reinen virtuellen Funktionen do_allocate, do_deallocate und do_is_equal, die eine abgeleitete Klasse implementiert. Die Schnittstelle besitzt einen virtuellen Destruktor. is_equal(other) bedeutet, dass beide Ressourcen die Allokationen der jeweils anderen freigeben können, nicht, dass sie identische Konfigurationen haben. operator== prüft &a == &b || a.is_equal(b).
Das Beispiel verwendet new_delete_resource(), eine Ressource mit statischer Lebensdauer, die auf ::operator new und ::operator delete basiert. Es alloziert und gibt einen Block frei, ohne hineinzuschreiben, und gibt anschließend true aus, weil wiederholte Aufrufe dieser Funktion dieselbe Ressource zurückgeben. Dieser Eintrag bezieht sich auf C++23; der bereitgestellte Arbeitsentwurf ist ein fortlaufend aktualisiertes Dokument und keine unveränderliche C++23-Ausgabe. Die Compileroption des Repositorys belegt keine Kompatibilität der Produktionslaufzeit.
Beispiele
#include <iostream>
#include <memory_resource>
int main() {
std::pmr::memory_resource* resource =
std::pmr::new_delete_resource();
void* p = resource->allocate(sizeof(int), alignof(int));
const bool equal = resource->is_equal(*std::pmr::new_delete_resource());
resource->deallocate(p, sizeof(int), alignof(int));
std::cout << std::boolalpha << equal << '\n';
}
Ergebnis
true
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.