CKTIS / C++
std::pmr::memory_resource — polymorfní paměťový prostředek
std::pmr::memory_resource je abstraktní rozhraní pro alokaci a uvolňování úložiště se zadaným zarovnáním. Umožňuje zvolit strategii alokace za běhu; std::pmr::polymorphic_allocator toto rozhraní propojuje s kódem, který očekává alokátor.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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, deklarovaný v <memory_resource>, představuje paměťový prostředek, nikoli typovaný alokátor nebo kontejner. Nelze jej přímo vytvořit jako instanci. std::pmr::polymorphic_allocator<T> používá prostředek zvolený za běhu, aniž by změnil svůj statický typ; uchovává ukazatel na prostředek, ale nepřebírá jeho vlastnictví. Prostředek musí zůstat dostupný po dobu operací, které jej používají.
allocate(bytes, alignment) alokuje alespoň bytes bajtů s požadovaným zarovnáním; alignment musí být mocninou dvou a výchozí hodnota je alignof(std::max_align_t). Nejde o obecnou operaci pro volání konstruktorů uživatelsky definovaných objektů. Selhání alokace se oznamuje výjimkou. deallocate(p, bytes, alignment) vyžaduje stejnou velikost a zarovnání a také blok, který dosud nebyl uvolněn a byl alokován prostřednictvím ekvivalentního prostředku. Nevolá destruktory objektů a nesmí vyvolat výjimku.
Veřejné funkce předávají práci soukromým čistě virtuálním funkcím do_allocate, do_deallocate a do_is_equal, které implementuje odvozená třída. Rozhraní má virtuální destruktor. is_equal(other) znamená, že oba prostředky mohou uvolňovat alokace toho druhého, nikoli že mají totožné konfigurace. operator== kontroluje &a == &b || a.is_equal(b).
Příklad používá new_delete_resource(), prostředek se statickou dobou života založený na ::operator new a ::operator delete. Alokuje a uvolní blok, aniž by do něj zapisoval, a poté vypíše true, protože opakovaná volání této funkce vracejí stejný prostředek. Tento záznam se vztahuje k C++23; dodaný pracovní návrh je průběžně aktualizovaný dokument, nikoli neměnné vydání C++23. Příznak kompilátoru v repozitáři nedokládá kompatibilitu produkčního běhového prostředí.
Příklady
#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';
}
Výsledek
true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.