KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::pmr::memory_resource — polymorfe geheugenresource

std::pmr::memory_resource is een abstracte interface voor het alloceren en vrijgeven van opslag met een opgegeven uitlijning. Hiermee kan tijdens runtime een allocatiestrategie worden gekozen; std::pmr::polymorphic_allocator verbindt die interface met code die een allocator verwacht.

Versie: 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, gedeclareerd in <memory_resource>, staat voor een opslagresource, niet voor een getypeerde allocator of container. Je kunt deze niet rechtstreeks instantiëren. std::pmr::polymorphic_allocator<T> gebruikt een resource die tijdens runtime is gekozen, zonder het statische type te wijzigen; de allocator bewaart een pointer naar de resource, maar neemt het eigendom ervan niet over. De resource moet beschikbaar blijven zolang bewerkingen deze gebruiken.

allocate(bytes, alignment) alloceert ten minste bytes bytes met de gevraagde uitlijning; alignment moet een macht van twee zijn en is standaard alignof(std::max_align_t). Dit is geen algemene bewerking om constructors van door gebruikers gedefinieerde objecten aan te roepen. Een allocatiefout wordt gemeld met een uitzondering. deallocate(p, bytes, alignment) vereist dezelfde grootte en uitlijning en een blok dat nog niet is vrijgegeven en via een gelijkwaardige resource is gealloceerd. De functie roept geen destructors van objecten aan en mag geen uitzonderingen gooien.

De publieke functies delegeren aan de private pure virtuele functies do_allocate, do_deallocate en do_is_equal, die door een afgeleide klasse worden geïmplementeerd. De interface heeft een virtuele destructor. is_equal(other) betekent dat beide resources elkaars allocaties kunnen vrijgeven, niet dat ze identieke configuraties hebben. operator== controleert &a == &b || a.is_equal(b).

Het voorbeeld gebruikt new_delete_resource(), een resource met statische levensduur die is gebaseerd op ::operator new en ::operator delete. Het alloceert en geeft een blok vrij zonder erin te schrijven en drukt daarna true af, omdat herhaalde aanroepen van deze functie dezelfde resource teruggeven. Dit artikel richt zich op C++23; het meegeleverde werkdocument is een levend document, geen vastgelegde C++23-editie. De compileroptie van de repository toont niet aan dat de productie-runtime compatibel is.

Voorbeelden

#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';
}

Resultaat

true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen