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

CKTIS / C++

std::pmr::memory_resource — ressource mémoire polymorphe

std::pmr::memory_resource est une interface abstraite permettant d’allouer et de libérer du stockage avec un alignement donné. Elle permet de choisir une stratégie d’allocation à l’exécution, tandis que std::pmr::polymorphic_allocator relie cette interface au code qui attend un allocateur.

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

Syntaxe

#include <memory_resource>
std::pmr::memory_resource* resource = std::pmr::new_delete_resource();
void* p = resource->allocate(bytes, alignment);
resource->deallocate(p, bytes, alignment);

std::pmr::memory_resource, déclaré dans <memory_resource>, représente une ressource de stockage, et non un allocateur typé ou un conteneur. Il ne peut pas être instancié directement. std::pmr::polymorphic_allocator<T> utilise une ressource choisie à l’exécution sans changer son type statique ; il stocke un pointeur vers la ressource sans en prendre possession. La ressource doit rester disponible pendant les opérations qui l’utilisent.

allocate(bytes, alignment) alloue au moins bytes octets avec l’alignement demandé ; alignment doit être une puissance de deux et vaut par défaut alignof(std::max_align_t). Il ne s’agit pas d’une opération générale destinée à appeler les constructeurs d’objets définis par l’utilisateur. Un échec d’allocation est signalé par une exception. deallocate(p, bytes, alignment) exige la même taille et le même alignement, ainsi qu’un bloc qui n’a pas déjà été libéré et qui a été alloué par une ressource équivalente. Cette fonction n’appelle pas les destructeurs des objets et ne doit pas lancer d’exception.

Les fonctions publiques délèguent aux fonctions virtuelles pures privées do_allocate, do_deallocate et do_is_equal, qu’une classe dérivée implémente. L’interface possède un destructeur virtuel. is_equal(other) signifie que les deux ressources peuvent libérer les allocations de l’autre, et non qu’elles ont des configurations identiques. operator== vérifie &a == &b || a.is_equal(b).

L’exemple utilise new_delete_resource(), une ressource à durée de vie statique reposant sur ::operator new et ::operator delete. Il alloue puis libère un bloc sans y écrire, puis affiche true, car les appels répétés à cette fonction renvoient la même ressource. Cette entrée vise C++23 ; le projet de norme fourni est un document évolutif, et non une édition C++23 figée. L’option du compilateur du dépôt n’établit pas la compatibilité de l’environnement d’exécution en production.

Exemples

#include <iostream>
#include <memory_resource>

int main() {
    std::pmr::memory_resource* resource =
        std::pmr::new_delete_resource();

    void* p = resource->allocate(sizeof(int), alignof(int));
    const bool equal = resource->is_equal(*std::pmr::new_delete_resource());
    resource->deallocate(p, sizeof(int), alignof(int));

    std::cout << std::boolalpha << equal << '\n';
}

Résultat

true

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