最終更新日時: 2025年10月14日 14時41分25秒 (JST)
Akira Takahashi が更新

履歴 編集

function
<memory>

# std::shared_ptr::use_count(C++11)

    long
      use_count() const noexcept; // (1) C++11
    constexpr long
      use_count() const noexcept; // (1) C++26

## 概要

所有権を持つユーザー数を取得する。

## 戻り値

`*this`が持つリソースを共有している`shared_ptr`のオブジェクト数を返す。

`0`が返る場合、`*this`は空の状態となる。

## 同期操作

しない

## 備考

複数スレッドが`use_count()`の戻り値に影響を与える場合、その戻り値は、おおよその値として扱われるべきである。この関数はスレッド間での同期をしないため、正確な値を求めてはならない。

## 例

    #include <iostream>
    #include <memory>

    int main()
    {
      std::shared_ptr<int> p(new int(3));
      std::shared_ptr<int> q = p;

      long count = p.use_count();
      std::cout << count << std::endl;
    }

### 出力

    2

## バージョン

### 言語

- C++11

### 処理系

- GCC: 4.4.7 ✅
- Clang: 3.0 ✅
- ICC: ?
- Visual C++: 2008 (TR1) ✅, 2010 ✅, 2012 ✅, 2013 ✅

## 参照

- P0521R0 Proposed Resolution for CA 14 (`shared_ptr use_count`/`unique`)
- P3037R6 `constexpr std::shared_ptr` and friends