Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::pmr::monotonic_buffer_resource — alokace s hromadným uvolněním

std::pmr::monotonic_buffer_resource poskytuje paměť pro postupné alokace a ignoruje jednotlivá uvolnění. release() vrátí bloky nadřazenému zdroji a resetuje zdroj pro další použití.

Verze: C++23; repository compiler flag, production runtime not attested

Syntaxe

#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 z hlavičky <memory_resource> je paměťový zdroj vhodný pro případy, kdy objekty vznikají postupně a paměť lze uvolnit najednou. Kontejnery PMR, například std::pmr::vector<int>, jej mohou používat prostřednictvím alokátoru. Jednotlivá volání dealokace žádné místo neuvolňují, takže při růstu kontejneru mohou dřívější bloky zůstat obsazené.

Lze předat vlastní počáteční buffer. Pokud zbývající místo nevyhovuje požadované velikosti a zarovnání, zdroj získá další blok od nadřazeného zdroje; velikosti bloků závisejí na implementaci. Bez explicitního argumentu upstream se použije výchozí paměťový zdroj. Počáteční buffer proto není pevnou hranicí spotřeby paměti.

std::pmr::monotonic_buffer_resource::release() vrátí všechny získané bloky nadřazenému zdroji a obnoví počáteční stav alokací, takže lze dodaný buffer znovu použít. Neuvolní samotný buffer vlastněný volajícím ani nezavolá destruktory uložených objektů. Nejprve zničte objekty a kontejnery, které tyto alokace používají; pouhé zavolání clear() na kontejner nestačí, protože si může ponechat kapacitu. Destruktor zdroje také volá release(). Buffer i nadřazený zdroj musí zůstat dostupné, dokud je zdroj používá.

Příklad zničí první vektor před voláním release() a poté vytvoří druhý se stejným zdrojem. Rozsah záznamu: C++23; příznak kompilátoru v repozitáři nepotvrzuje produkční běhové prostředí. Odkazovaný dokument je průběžně upravovaný pracovní návrh, nikoli neměnné vydání C++23.

Příklady

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

Výsledek

6
4

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje