CKTIS / C++
std::pmr::vector: zasoby pamięci i alokatory elementów
Wybierz zasób pamięci dla wektora PMR i sprawdź, kiedy ten sam zasób trafia do jego elementów, a kiedy zwykły wektor korzysta z innego alokatora.
Wersja: ISO C++23; implementation support may vary
Składnia
#include <vector>
#include <string>
#include <memory_resource>
#include <cstddef>
// Equivalent types (T is the element type):
// std::pmr::vector<T> = std::vector<T, std::pmr::polymorphic_allocator<T>>
// std::pmr::string = std::basic_string<char, std::char_traits<char>, std::pmr::polymorphic_allocator<char>>
// In a block scope:
std::byte buffer[4096];
std::pmr::monotonic_buffer_resource arena{buffer, sizeof buffer};
std::pmr::vector<std::pmr::string> data{&arena};
data.emplace_back("PMR");std::pmr::vector<T> z <vector> to alias std::vector<T, std::pmr::polymorphic_allocator<T>>, a nie osobna klasa kontenera. std::pmr::string z <string> to std::basic_string dla char z alokatorem std::pmr::polymorphic_allocator<char>. Oba aliasy i std::byte są dostępne od C++17 i należą do C++23; obsługa zależy od implementacji.
Alokator polimorficzny kieruje żądania przydziału pamięci do std::pmr::memory_resource wybranego w czasie działania. W konstrukcji data{&arena} jawnie wybierasz arena na zasób pamięci dla elementów wektora. Alokator skonstruowany domyślnie pobiera bieżący zasób przez std::pmr::get_default_resource(). Nie jest to to samo co std::allocator<T>, domyślny typ alokatora zwykłego std::vector<T>.
Przy emplace_back("PMR") w std::pmr::vector<std::pmr::string> konstrukcja uwzględniająca alokator przekazuje zasób wektora do tworzonego napisu, który użyje go, jeśli będzie potrzebował osobnej pamięci na znaki. Jeżeli DATA oznacza std::pmr::string, zwykły std::vector<DATA> nadal używa std::allocator<DATA> do przechowywania elementów. Nie przekazuje zasobu do konstruktora napisu w tym wywołaniu, więc napis pobiera domyślny zasób PMR. Z kolei std::string nie zaczyna używać PMR tylko dlatego, że jest elementem wektora PMR.
std::byte z <cstddef> to typ wyliczeniowy o ograniczonym zasięgu, którego typem bazowym jest unsigned char. Jego tablica służy tu jako surowa pamięć dla std::pmr::monotonic_buffer_resource z <memory_resource>. Gdy dostępna pamięć nie wystarcza do obsłużenia żądania, zasób zwraca się do zasobu nadrzędnego o kolejny blok. Jeżeli rolę zasobu nadrzędnego pełni std::pmr::null_memory_resource(), taka próba kończy się wyjątkiem std::bad_alloc.
Wektor nie jest właścicielem zasobu. Zadeklaruj bufor, zasób i kontener w tej kolejności, aby kontener został zniszczony jako pierwszy. Nie wywołuj release(), dopóki istnieją obiekty korzystające z pamięci przydzielonej przez zasób. Zasób monotoniczny nie odzyskuje miejsca przy pojedynczych zwolnieniach.
Przykłady
#include <cstddef>
#include <iostream>
#include <memory_resource>
#include <string>
#include <type_traits>
#include <vector>
int main() {
using DATA = std::pmr::string;
static_assert(std::is_same_v<std::vector<DATA>::allocator_type,
std::allocator<DATA>>);
std::byte buffer[4096];
std::pmr::monotonic_buffer_resource arena{buffer, sizeof buffer};
std::pmr::vector<DATA> pmr_data{&arena};
std::vector<DATA> ordinary_data;
pmr_data.emplace_back("PMR");
ordinary_data.emplace_back("PMR");
std::cout << std::boolalpha
<< "PMR vector uses arena: "
<< (pmr_data.get_allocator().resource() == &arena) << '\n'
<< "PMR vector element uses arena: "
<< (pmr_data.front().get_allocator().resource() == &arena) << '\n'
<< "Ordinary vector element uses default resource: "
<< (ordinary_data.front().get_allocator().resource() ==
std::pmr::get_default_resource()) << '\n';
}Wynik
PMR vector uses arena: true PMR vector element uses arena: true Ordinary vector element uses default resource: true
Asercja statyczna sprawdza typ alokatora zwykłego wektora. Trzy wyniki `true` potwierdzają tożsamość zasobów, a nie przydział pamięci na znaki: krótki napis może zmieścić się wewnątrz własnego obiektu.
Powiązane lekcje
- C++ · Lekcja 18 · Zaawansowany · Wersja: 3
Źródła
- Header <vector> synopsis [vector.syn]
- Header <string> synopsis [string.syn]
- Header <cstddef> synopsis [cstddef.syn]
- Class template polymorphic_allocator [mem.poly.allocator.class]
- Allocator-aware containers [container.alloc.reqmts]
- Class monotonic_buffer_resource [mem.res.monotonic.buffer]
- Access to program-wide memory_resource objects [mem.res.global]
- N4950: Working Draft, Standard for Programming Language C++