CKTIS / C++
std::pmr::unsynchronized_pool_resource — pools de mémoire sans synchronisation
std::pmr::unsynchronized_pool_resource gère des pools de blocs mémoire pour les allocateurs polymorphes. Les blocs libérés peuvent être réutilisés, mais il faut gérer soigneusement la durée de vie des ressources et empêcher les accès simultanés depuis plusieurs threads.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <memory_resource>
std::pmr::unsynchronized_pool_resource pool;
std::pmr::unsynchronized_pool_resource pool_with_upstream{upstream};
std::pmr::unsynchronized_pool_resource configured_pool{options, upstream};std::pmr::unsynchronized_pool_resource, déclaré dans <memory_resource>, est une ressource mémoire dérivée de std::pmr::memory_resource. Elle gère des pools de blocs de tailles différentes. Lorsqu’un pool est épuisé, elle obtient un autre bloc de mémoire auprès de la ressource amont (upstream) ; les demandes dépassant la plus grande taille de pool prise en charge sont directement transmises à cette ressource. Les blocs libérés peuvent servir aux allocations suivantes.
Le constructeur par défaut utilise std::pmr::get_default_resource(). Il est également possible de fournir un pointeur vers une ressource amont valide et std::pmr::pool_options. Le pool ne possède pas sa ressource amont : celle-ci doit vivre plus longtemps que le pool. options() renvoie les paramètres effectifs, qui peuvent différer de ceux demandés ; les tailles des blocs et le nombre d’allocations ne sont pas des garanties portables.
N’accédez pas simultanément à la même ressource depuis plusieurs threads. Assurez une synchronisation externe ou utilisez std::pmr::synchronized_pool_resource. Toutefois, la synchronisation de la ressource ne rend pas sûres les modifications simultanées d’un conteneur qui l’utilise.
release() restitue à la ressource amont toute la mémoire allouée, y compris les blocs que les clients n’ont pas encore rendus ; la destruction effectue cette opération automatiquement. Cela ne remplace pas les appels aux destructeurs des objets. Détruisez les conteneurs et les objets qui utilisent la mémoire avant d’appeler release() ou de détruire le pool. Dans l’exemple, la portée imbriquée assure cet ordre pour std::pmr::vector<int>.
Exemples
#include <iostream>
#include <memory_resource>
#include <vector>
int main() {
std::pmr::unsynchronized_pool_resource pool;
{
std::pmr::vector<int> values{&pool};
values.reserve(3);
values.push_back(10);
values.push_back(20);
values.push_back(30);
int sum = 0;
for (int value : values) {
sum += value;
}
std::cout << values.size() << ' ' << sum << '\n';
}
pool.release();
}
Résultat
3 60
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.