База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::pmr::memory_resource — полиморфен ресурс за памет

std::pmr::memory_resource е абстрактен интерфейс за заделяне и освобождаване на памет със зададено подравняване. Той позволява избор на стратегия за заделяне по време на изпълнение, а std::pmr::polymorphic_allocator свързва този интерфейс с код, който очаква алокатор.

Версия: C++23; repository compiler flag, production runtime not attested

Синтаксис

#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, деклариран в <memory_resource>, представлява ресурс за памет, а не типизиран алокатор или контейнер. Не може да бъде инстанциран директно. std::pmr::polymorphic_allocator<T> използва ресурс, избран по време на изпълнение, без да променя статичния си тип; съхранява указател към ресурса, без да поема собствеността върху него. Ресурсът трябва да остане достъпен по време на операциите, които го използват.

allocate(bytes, alignment) заделя поне bytes байта с поисканото подравняване; alignment трябва да е степен на две, а стойността по подразбиране е alignof(std::max_align_t). Това не е обща операция за извикване на конструкторите на дефинирани от потребителя обекти. Неуспешното заделяне се съобщава чрез изключение. deallocate(p, bytes, alignment) изисква същия размер и подравняване, както и блок, който не е бил освобождаван преди това и е бил заделен чрез еквивалентен ресурс. Не извиква деструкторите на обектите и не трябва да хвърля изключения.

Публичните функции делегират към частните чисто виртуални функции do_allocate, do_deallocate и do_is_equal, които се имплементират от производен клас. Интерфейсът има виртуален деструктор. is_equal(other) означава, че двата ресурса могат да освобождават взаимно заделената памет, а не че имат идентични конфигурации. operator== проверява &a == &b || a.is_equal(b).

Примерът използва new_delete_resource(), ресурс със статично време на живот, базиран на ::operator new и ::operator delete. Той заделя и освобождава блок, без да записва в него, след което отпечатва true, защото повторните извиквания на тази функция връщат същия ресурс. Този запис е насочен към C++23; предоставеният работен проект е актуализиран документ, а не фиксирано издание на C++23. Флагът на компилатора в хранилището не доказва съвместимост с продукционната среда за изпълнение.

Примери

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

Резултат

true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници