Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje