std::weak_ptr<T>:: use_count

管理対象オブジェクトの所有権を共有する shared_ptr インスタンスの数を返します。管理対象オブジェクトが既に削除されている場合、つまり * this が空の場合は ​ 0 ​ を返します。

パラメータ

(なし)

戻り値

管理対象オブジェクトの所有権を共有している shared_ptr インスタンスの数（呼び出し時点）。

注記

この関数の使用方法と動作は std::shared_ptr::use_count と類似していますが、異なるカウントを返します。

例

#include <iostream>
#include <memory>
std::weak_ptr<int> gwp;
void observe_gwp()
{
    std::cout << "use_count(): " << gwp.use_count() << "\t id: ";
    if (auto sp = gwp.lock())
        std::cout << *sp << '\n';
    else
        std::cout << "??\n";
}
void share_recursively(std::shared_ptr<int> sp, int depth)
{
    observe_gwp(); // : 2 3 4
    if (1 < depth)
        share_recursively(sp, depth - 1);
    observe_gwp(); // : 4 3 2
}
int main()
{
    observe_gwp();
    {
        auto sp = std::make_shared<int>(42);
        gwp = sp;
        observe_gwp(); // : 1
        share_recursively(sp, 3); // : 2 3 4 4 3 2
        observe_gwp(); // : 1
    }
    observe_gwp(); // : 0
}

use_count(): 0   id: ??
use_count(): 1   id: 42
use_count(): 2   id: 42
use_count(): 3   id: 42
use_count(): 4   id: 42
use_count(): 4   id: 42
use_count(): 3   id: 42
use_count(): 2   id: 42
use_count(): 1   id: 42
use_count(): 0   id: ??

関連項目