KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::pmr::monotonic_buffer_resource — allocatie met collectieve vrijgave

std::pmr::monotonic_buffer_resource levert opslag voor opeenvolgende allocaties en negeert afzonderlijke deallocaties. release() geeft blokken terug aan de upstream-resource en herstelt de resource voor hergebruik.

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

Syntax

#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 uit <memory_resource> is een geheugenresource die handig is wanneer objecten stapsgewijs worden opgebouwd en opslag in één keer kan worden teruggewonnen. PMR-containers zoals std::pmr::vector<int> kunnen deze via een allocator gebruiken. Afzonderlijke deallocatieaanroepen leveren geen ruimte terug; bij groei van een container kunnen eerdere blokken dus bezet blijven.

Je kunt een eigen beginbuffer opgeven. Als de resterende ruimte niet voldoet aan de gevraagde grootte en uitlijning, vraagt de resource een volgend blok aan bij de upstream-resource; de blokgroottes zijn implementatieafhankelijk. Zonder expliciet argument upstream wordt de standaard geheugenresource gebruikt. De beginbuffer is daarom geen harde limiet voor het geheugengebruik.

std::pmr::monotonic_buffer_resource::release() geeft alle verkregen blokken terug aan de upstream-resource en herstelt de oorspronkelijke allocatietoestand, zodat de opgegeven buffer opnieuw kan worden gebruikt. De functie maakt de buffer zelf, die eigendom is van de aanroeper, niet vrij en roept geen destructors aan van opgeslagen objecten. Vernietig eerst objecten en containers die deze allocaties gebruiken; alleen clear() aanroepen op een container is niet voldoende, omdat de capaciteit behouden kan blijven. Ook de destructor van de resource roept release() aan. De buffer en upstream-resource moeten beschikbaar blijven zolang de resource ze gebruikt.

Het voorbeeld vernietigt de eerste vector vóór release() en maakt daarna een tweede aan met dezelfde resource. Reikwijdte van dit item: C++23; de compileroptie van de repository bevestigt niet de productie-runtimeomgeving. Het gekoppelde document is een evoluerend werkdocument, geen bevroren C++23-publicatie.

Voorbeelden

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

Resultaat

6
4

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