Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::pmr::memory_resource — polymorfný pamäťový prostriedok

std::pmr::memory_resource je abstraktné rozhranie na alokáciu a uvoľňovanie úložiska so zadaným zarovnaním. Umožňuje zvoliť stratégiu alokácie za behu; std::pmr::polymorphic_allocator prepája toto rozhranie s kódom, ktorý očakáva alokátor.

Verzia: 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, deklarovaný v <memory_resource>, predstavuje pamäťový prostriedok, nie typovaný alokátor ani kontajner. Nemožno ho priamo vytvoriť ako inštanciu. std::pmr::polymorphic_allocator<T> používa prostriedok zvolený za behu bez zmeny svojho statického typu; uchováva ukazovateľ na prostriedok, ale nepreberá jeho vlastníctvo. Prostriedok musí zostať dostupný počas operácií, ktoré ho používajú.

allocate(bytes, alignment) alokuje aspoň bytes bajtov s požadovaným zarovnaním; alignment musí byť mocninou dvoch a predvolená hodnota je alignof(std::max_align_t). Nejde o všeobecnú operáciu na volanie konštruktorov používateľom definovaných objektov. Zlyhanie alokácie sa oznamuje výnimkou. deallocate(p, bytes, alignment) vyžaduje rovnakú veľkosť a zarovnanie, ako aj blok, ktorý ešte nebol uvoľnený a bol alokovaný prostredníctvom ekvivalentného prostriedku. Nevolá deštruktory objektov a nesmie vyvolať výnimku.

Verejné funkcie delegujú na súkromné čisto virtuálne funkcie do_allocate, do_deallocate a do_is_equal, ktoré implementuje odvodená trieda. Rozhranie má virtuálny deštruktor. is_equal(other) znamená, že oba prostriedky môžu uvoľňovať alokácie toho druhého, nie že majú totožné konfigurácie. operator== kontroluje &a == &b || a.is_equal(b).

Príklad používa new_delete_resource(), prostriedok so statickou dobou života založený na ::operator new a ::operator delete. Alokuje a uvoľní blok bez zapisovania doň a potom vypíše true, pretože opakované volania tejto funkcie vracajú ten istý prostriedok. Tento záznam sa vzťahuje na C++23; dodaný pracovný návrh je priebežne aktualizovaný dokument, nie nemenné vydanie C++23. Príznak kompilátora v repozitári nepotvrdzuje kompatibilitu produkčného runtime prostredia.

Prí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ýsledok

true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje