CKTIS / C++
std::pmr::vector: paměťové zdroje a alokátory prvků
Vyber paměťový zdroj pro vektor PMR a zjisti, kdy stejný zdroj dostanou jeho prvky a jak se v tomto ohledu liší obyčejný vektor.
Verze: ISO C++23; implementation support may vary
Syntaxe
#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> je alias pro std::vector<T, std::pmr::polymorphic_allocator<T>>, nikoli samostatná třída kontejneru. std::pmr::string z <string> je std::basic_string pro char s alokátorem std::pmr::polymorphic_allocator<char>. Oba aliasy i std::byte byly zavedeny v C++17 a jsou součástí C++23; podpora se může lišit podle implementace.
Polymorfní alokátor předává požadavky na alokaci paměťovému zdroji std::pmr::memory_resource, který se vybírá za běhu. Zápisem data{&arena} výslovně zvolíš arena jako zdroj paměti pro prvky vektoru. Výchozím způsobem zkonstruovaný polymorfní alokátor získá aktuální zdroj voláním std::pmr::get_default_resource(). To není totéž jako std::allocator<T>, výchozí typ alokátoru běžného std::vector<T>.
Při volání emplace_back("PMR") na std::pmr::vector<std::pmr::string> konstrukce zohledňující alokátor předá zdroj vektoru novému řetězci. Ten ho použije, pokud potřebuje samostatnou paměť pro znaky. Je-li DATA označením pro std::pmr::string, běžný std::vector<DATA> stále používá pro uložení prvků std::allocator<DATA>. Při tomto volání nepředá konstruktoru řetězce žádný zdroj, takže řetězec použije výchozí zdroj PMR. Naopak std::string nezačne používat PMR jen proto, že je prvkem vektoru PMR.
std::byte z <cstddef> je výčtový typ s vlastním oborem platnosti a podkladovým typem unsigned char. Pole tohoto typu zde poskytuje surovou paměť pro std::pmr::monotonic_buffer_resource z <memory_resource>. Když se požadavek nevejde do dostupného prostoru, zdroj požádá o další blok svůj nadřazený zdroj. Je-li jím std::pmr::null_memory_resource(), požadavek vyvolá výjimku std::bad_alloc.
Vektor zdroj nevlastní. Deklaruj nejprve vyrovnávací paměť, poté zdroj a nakonec kontejner, aby byl kontejner zničen jako první. Nevolej release(), dokud existují objekty závislé na paměti přidělené zdrojem. Monotónní zdroj nezískává prostor zpět při jednotlivých dealokacích.
Příklady
#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';
}Výsledek
PMR vector uses arena: true PMR vector element uses arena: true Ordinary vector element uses default resource: true
Statická kontrola ověřuje typ alokátoru běžného vektoru. Tři výsledky `true` potvrzují totožnost zdrojů, nikoli přidělení paměti pro znaky: krátký řetězec se může vejít do vlastního objektu.
Související lekce
- C++ · Lekce 18 · Pokročilá · Verze: 3
Zdroje
- 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++