CKTIS / C++
std::pmr::vector: geheugenbronnen en allocators van elementen
Kies een geheugenbron voor een PMR-vector en ontdek wanneer de elementen dezelfde bron krijgen en hoe een gewone vector zich anders gedraagt.
Versie: ISO C++23; implementation support may vary
Syntax
#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> uit <vector> is een alias voor std::vector<T, std::pmr::polymorphic_allocator<T>>, geen afzonderlijke containerklasse. std::pmr::string uit <string> is std::basic_string voor char met std::pmr::polymorphic_allocator<char>. Beide aliassen en std::byte zijn geïntroduceerd in C++17 en maken deel uit van C++23; de ondersteuning kan per implementatie verschillen.
Een polymorfe allocator stuurt allocatieverzoeken naar een std::pmr::memory_resource die tijdens de uitvoering wordt gekozen. Met data{&arena} kies je expliciet arena als bron voor de opslag van de vectorelementen. Een standaard geconstrueerde polymorfe allocator krijgt de huidige bron via std::pmr::get_default_resource(). Dat is niet hetzelfde als std::allocator<T>, het standaardallocatortype van een gewone std::vector<T>.
Bij emplace_back("PMR") op een std::pmr::vector<std::pmr::string> geeft de allocatorbewuste constructie de bron van de vector door aan de nieuwe string. Die gebruikt de bron als er aparte tekenopslag nodig is. Als DATA voor std::pmr::string staat, gebruikt een gewone std::vector<DATA> nog steeds std::allocator<DATA> voor de opslag van de elementen. Bij deze aanroep geeft de vector geen bron door aan de constructor van de string, die daardoor de standaardbron van PMR krijgt. Omgekeerd gaat een std::string niet ineens PMR gebruiken omdat die een element van een PMR-vector is.
std::byte uit <cstddef> is een enumeratie met een eigen scope en onderliggend type unsigned char. Een array daarvan levert hier ruwe opslag aan een std::pmr::monotonic_buffer_resource uit <memory_resource>. Past een verzoek niet in de beschikbare ruimte, dan vraagt de resource een nieuw blok aan zijn achterliggende geheugenbron. Is dat std::pmr::null_memory_resource(), dan werpt het verzoek std::bad_alloc op.
De vector is geen eigenaar van de geheugenbron. Declareer de buffer, de bron en de container in die volgorde, zodat de container als eerste wordt vernietigd. Roep release() niet aan zolang er objecten afhankelijk zijn van opslag die de bron heeft toegewezen. Een monotone geheugenbron wint geen ruimte terug bij afzonderlijke deallocaties.
Voorbeelden
#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';
}Resultaat
PMR vector uses arena: true PMR vector element uses arena: true Ordinary vector element uses default resource: true
De statische assertie controleert het allocatortype van de gewone vector. De drie resultaten `true` bevestigen de identiteit van de geheugenbronnen, niet dat er tekenopslag is toegewezen: een korte string kan in zijn eigen object passen.
Gerelateerde lessen
- C++ · Les 18 · Gevorderd · Versie: 3
Bronnen
- 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++