Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::pmr::synchronized_pool_resource — pools de mémoire synchronisés

std::pmr::synchronized_pool_resource gère des pools de blocs mémoire et permet leur accès simultané depuis plusieurs threads. Il peut fournir du stockage aux conteneurs PMR, mais la synchronisation de la ressource ne rend pas sûres les modifications simultanées d’un conteneur.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

#include <memory_resource>

std::pmr::synchronized_pool_resource pool;
std::pmr::synchronized_pool_resource configured(options, upstream);

std::pmr::synchronized_pool_resource, déclaré dans <memory_resource>, est une ressource mémoire qui gère des pools de blocs de tailles différentes. Elle obtient de plus grands blocs auprès d’une ressource amont (upstream) et les divise en blocs. Les demandes dépassant la plus grande taille prise en charge par ses pools sont directement transmises à la ressource amont.

Plusieurs threads peuvent accéder à cette ressource sans synchronisation externe. Cela ne signifie pas qu’un conteneur partagé qui l’utilise peut être modifié simultanément sans restriction. À l’inverse, std::pmr::unsynchronized_pool_resource n’autorise pas l’accès simultané depuis plusieurs threads.

Le constructeur par défaut choisit std::pmr::get_default_resource() comme ressource amont. Un autre constructeur accepte std::pmr::pool_options et un pointeur vers la ressource amont ; la ressource ne prend pas possession de celle-ci. max_blocks_per_chunk et largest_required_pool_block règlent les pools, mais l’implémentation peut ajuster leurs valeurs. options() renvoie les paramètres utilisés.

La ressource doit vivre plus longtemps que les conteneurs qui l’utilisent, et la ressource amont doit rester valide pendant son utilisation. release() restitue toute la mémoire allouée, y compris les blocs encore détenus, sans appeler les destructeurs des objets stockés. Détruisez les objets et les conteneurs avant d’appeler release(). Le destructeur de la ressource libère également sa mémoire.

L’exemple crée un std::pmr::vector<int> utilisant le pool et affiche la somme de ses éléments. La portée interne détruit le vecteur avant release(). Il ne suppose ni un nombre précis d’allocations ni la réutilisation d’une adresse particulière.

Exemples

#include <iostream>
#include <memory_resource>
#include <vector>

int main() {
    std::pmr::synchronized_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 << sum << '\n';
    }
    pool.release();
}

Résultat

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.

Sources