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

CKTIS / C++

std::enable_shared_from_this : partager la propriété existante d’un objet

std::enable_shared_from_this permet à un objet d’obtenir un shared_ptr utilisant le même bloc de contrôle que son propriétaire actuel.

Version : C++23

Syntaxe

template<class T>
class enable_shared_from_this {
public:
    std::shared_ptr<T> shared_from_this();
    std::shared_ptr<const T> shared_from_this() const;
    std::weak_ptr<T> weak_from_this() noexcept;
    std::weak_ptr<const T> weak_from_this() const noexcept;
};

Une classe T qui dérive publiquement et sans ambiguïté de std::enable_shared_from_this<T> dans <memory> reçoit shared_from_this() et weak_from_this(). Quand le premier std::shared_ptr adapté prend possession, il initialise un lien faible caché ; un appel ultérieur à shared_from_this() crée un propriétaire du même objet et du même bloc de contrôle.

Appeler shared_from_this() avant la gestion par un shared_ptr compatible construit depuis un weak_ptr vide et lance std::bad_weak_ptr. weak_from_this() est noexcept et peut renvoyer un pointeur faible vide, ce qui permet de tester la propriété sans prolonger d’abord la durée de vie.

Ne crée pas std::shared_ptr<T>(this) : cela crée un bloc de contrôle indépendant et risque une double suppression. Un objet sur la pile, un héritage privé ou ambigu, ou un second propriétaire indépendant n’établissent pas le lien requis. Préfère std::make_shared<T>, puis expose shared_from_this().

Exemples

#include <iostream>
#include <memory>

struct Node : std::enable_shared_from_this<Node> {
    explicit Node(int value) : value(value) {}
    int value;
};

int main() {
    auto first = std::make_shared<Node>(7);
    auto second = first->shared_from_this();
    std::cout << (first.get() == second.get()) << ' '
              << first.use_count() << ' ' << second->value << '\n';
}

Résultat

1 2 7

std::enable_shared_from_this → 1 2 7

Sources