Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::pmr::monotonic_buffer_resource — alokacja ze zbiorczym zwalnianiem

std::pmr::monotonic_buffer_resource udostępnia pamięć kolejnym alokacjom, ignorując pojedyncze dealokacje. release() zwalnia bloki pobrane z zasobu nadrzędnego i resetuje zasób do ponownego użycia.

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

Składnia

#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 nagłówka <memory_resource> to zasób pamięci przydatny, gdy obiekty powstają etapami, a pamięć można odzyskać zbiorczo. Kontenery PMR, takie jak std::pmr::vector<int>, mogą korzystać z niego przez alokator. Pojedyncze wywołania dealokacji nie odzyskują miejsca; wzrost kontenera może więc pozostawiać wcześniejsze bloki zajęte.

Można przekazać własny bufor początkowy. Gdy brakuje miejsca z wymaganym wyrównaniem, zasób pobiera kolejny blok z zasobu nadrzędnego; rozmiary bloków zależą od implementacji. Bez jawnego argumentu upstream używany jest domyślny zasób pamięci. Bufor początkowy nie jest zatem twardym limitem zużycia pamięci.

std::pmr::monotonic_buffer_resource::release() zwraca wszystkie pobrane bloki zasobowi nadrzędnemu i przywraca początkowy stan alokacji, umożliwiając ponowne wykorzystanie dostarczonego bufora. Nie zwalnia samego bufora użytkownika ani nie wywołuje destruktorów przechowywanych obiektów. Najpierw zniszcz obiekty i kontenery korzystające z tych alokacji; samo clear() kontenera nie wystarcza, ponieważ może zachować pojemność. Destruktor zasobu również wywołuje release(). Bufor oraz zasób nadrzędny muszą pozostawać dostępne podczas korzystania z nich przez zasób.

Przykład niszczy pierwszy wektor przed release(), a następnie tworzy drugi z użyciem tego samego zasobu. Zakres wpisu: C++23; flaga kompilatora repozytorium nie potwierdza środowiska wykonawczego produkcji. Podlinkowany dokument jest rozwijanym szkicem, a nie zamrożoną publikacją C++23.

Przykłady

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

Wynik

6
4

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła