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.