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

CKTIS / C++

std::pmr::monotonic_buffer_resource — разпределяне с групово освобождаване

std::pmr::monotonic_buffer_resource предоставя памет за последователни заделяния и пренебрегва отделните освобождавания. release() връща блоковете към upstream ресурса и нулира ресурса за повторна употреба.

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

Синтаксис

#include <cstddef>
#include <memory_resource>

void use_resource(void* buffer, std::size_t buffer_size,
                  std::pmr::memory_resource* upstream) {
    {
        std::pmr::monotonic_buffer_resource resource;
    }
    {
        std::pmr::monotonic_buffer_resource resource(buffer, buffer_size);
    }
    {
        std::pmr::monotonic_buffer_resource resource(buffer, buffer_size, upstream);
        resource.release();
    }
}

std::pmr::monotonic_buffer_resource от <memory_resource> е ресурс за памет, подходящ, когато обектите се създават постепенно и паметта може да бъде възстановена наведнъж. PMR контейнери като std::pmr::vector<int> могат да го използват чрез алокатор. Отделните извиквания за освобождаване не връщат място, затова при нарастване на контейнер предишните блокове може да останат заети.

Може да се подаде начален буфер. Когато оставащото място не удовлетворява изискванията за размер и подравняване, ресурсът получава допълнителен блок от upstream ресурса си; размерите на блоковете зависят от реализацията. Ако аргументът upstream не е зададен изрично, се използва ресурсът за памет по подразбиране. Следователно началният буфер не е твърда граница за потреблението на памет.

std::pmr::monotonic_buffer_resource::release() връща всички получени блокове към upstream ресурса и възстановява началното състояние на заделяне, което позволява подаденият буфер да се използва отново. Функцията не освобождава самия буфер, който принадлежи на извикващия, и не извиква деструкторите на съхраняваните обекти. Първо унищожете обектите и контейнерите, използващи тези заделяния; само извикването на clear() за контейнер не е достатъчно, защото той може да запази капацитета си. Деструкторът на ресурса също извиква release(). Буферът и upstream ресурсът трябва да остават достъпни, докато ресурсът ги използва.

Примерът унищожава първия вектор преди release(), след което създава втори със същия ресурс. Обхват на записа: C++23; флагът на компилатора в хранилището не удостоверява производствената среда за изпълнение. Свързаният документ е развиващ се работен проект, а не окончателно издание на C++23.

Примери

#include <cstddef>
#include <iostream>
#include <memory_resource>
#include <vector>

int main() {
    alignas(std::max_align_t) std::byte buffer[256];
    std::pmr::monotonic_buffer_resource resource(buffer, sizeof buffer);

    {
        std::pmr::vector<int> values(&resource);
        values.reserve(3);
        values.push_back(1);
        values.push_back(2);
        values.push_back(3);
        std::cout << values[0] + values[1] + values[2] << '\n';
    }

    resource.release();

    {
        std::pmr::vector<int> values(&resource);
        values.push_back(4);
        std::cout << values.front() << '\n';
    }
}

Резултат

6
4

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

Източници