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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.