CKTIS / C++
std::pmr::vector : ressources mémoire et allocateurs des éléments
Choisissez une ressource mémoire pour un vecteur PMR et découvrez quand ses éléments reçoivent cette même ressource, contrairement à ceux d’un vecteur ordinaire.
Version : 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>, déclaré dans <vector>, est un alias de std::vector<T, std::pmr::polymorphic_allocator<T>>, et non une classe de conteneur distincte. std::pmr::string, déclaré dans <string>, est std::basic_string pour char avec std::pmr::polymorphic_allocator<char>. Ces deux alias et std::byte existent depuis C++17 et font partie de C++23 ; leur prise en charge peut varier selon l’implémentation.
Un allocateur polymorphe transmet les demandes d’allocation à une std::pmr::memory_resource choisie à l’exécution. Avec data{&arena}, vous choisissez explicitement arena pour le stockage des éléments du vecteur. Un allocateur polymorphe construit par défaut obtient la ressource courante via std::pmr::get_default_resource(). Ce n’est pas la même chose que std::allocator<T>, le type d’allocateur par défaut d’un std::vector<T> ordinaire.
Lors d’un appel à emplace_back("PMR") sur un std::pmr::vector<std::pmr::string>, la construction avec allocateur transmet la ressource du vecteur à la nouvelle chaîne. Celle-ci l’utilise si elle a besoin d’un stockage séparé pour ses caractères. Si DATA désigne std::pmr::string, un std::vector<DATA> ordinaire utilise toujours std::allocator<DATA> pour stocker ses éléments. Dans cet appel, il ne transmet aucune ressource au constructeur de la chaîne, qui prend donc la ressource PMR par défaut. À l’inverse, une std::string ne se met pas à utiliser PMR parce qu’elle est un élément d’un vecteur PMR.
std::byte, déclaré dans <cstddef>, est une énumération à portée propre dont le type sous-jacent est unsigned char. Un tableau de ces valeurs sert ici de stockage brut à une std::pmr::monotonic_buffer_resource déclarée dans <memory_resource>. Si l’espace disponible ne suffit pas à une demande, la ressource demande un autre bloc à sa ressource amont. Si cette dernière est std::pmr::null_memory_resource(), la demande lève std::bad_alloc.
Le vecteur n’est pas propriétaire de la ressource. Déclarez le tampon, la ressource, puis le conteneur pour que le conteneur soit détruit en premier. N’appelez pas release() tant que des objets dépendent encore du stockage alloué par la ressource. Une ressource monotone ne récupère pas d’espace lors des désallocations individuelles.
Exemples
#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';
}Résultat
PMR vector uses arena: true PMR vector element uses arena: true Ordinary vector element uses default resource: true
L’assertion statique contrôle le type d’allocateur du vecteur ordinaire. Les trois résultats `true` confirment l’identité des ressources, pas l’allocation de mémoire pour les caractères : une chaîne courte peut tenir dans son propre objet.
Leçons associées
- C++ · Leçon 18 · Avancé · Version : 3
Sources
- 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++