cpprefjp.github.io/reference/memory/shared_ptr.html at master · cpprefjp/cpprefjp.github.io

685 lines (616 loc) · 33 KB
<!doctype html>
<html class="cpprefjp" lang="ja" itemscope="" itemtype="http://schema.org/WebPage">
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-NXNBNVBTJS"></script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-NXNBNVBTJS');
        <meta charset="UTF-8">
        <title>std::shared_ptr - cpprefjp C++日本語リファレンス</title>
        <meta name="viewport" content="width=device-width,initial-scale=1">
        <meta name="keywords" content="
  C++,標準ライブラリ,リファレンス,ドキュメント,STL,std,memory,std,class template,cpp11
        <meta name="title" content="std::shared_ptr - cpprefjp C++日本語リファレンス" />
        <meta itemprop="name" content="std::shared_ptr - cpprefjp C++日本語リファレンス" />
        <meta property="og:title" content="std::shared_ptr - cpprefjp C++日本語リファレンス" />
        <meta property="og:url" content="https://cpprefjp.github.io/reference/memory/shared_ptr.html" />
        <meta property="og:site_name" content="cpprefjp - C++日本語リファレンス" />
        <meta property="og:type" content="article" />
        <meta property="og:description" content="`shared_ptr`は、指定されたリソースへの所有権(ownership)を共有(share)するスマートポインタである。" />
        <meta name="twitter:card" content="summary" />
        <meta name="twitter:title" content="std::shared_ptr - cpprefjp C++日本語リファレンス" />
        <meta name="twitter:url" content="https://cpprefjp.github.io/reference/memory/shared_ptr.html" />
        <meta name="twitter:description" content="`shared_ptr`は、指定されたリソースへの所有権(ownership)を共有(share)するスマートポインタである。" />
  <link rel="alternate" type="application/atom+xml" title="Atom" href="https://cpprefjp.github.io/rss.xml" />
<link rel="apple-touch-icon" sizes="180x180" href="../../static/favicons/apple-touch-icon.png?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc">
<link rel="icon" type="image/png" sizes="32x32" href="../../static/favicons/favicon-32x32.png?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc">
<link rel="icon" type="image/png" sizes="16x16" href="../../static/favicons/favicon-16x16.png?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc">
<link rel="manifest" href="../../manifest.json?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc">
<meta name="theme-color" content="#f5f8fc">
<link rel="stylesheet" href="../../static/pygments/default.css?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc">
<!-- <link rel="stylesheet" href="../../static/css/root.css"> -->
<link href="../../static/kunai/css/kunai-stage-0.css?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc" rel="stylesheet">
<link href="../../static/kunai/css/kunai-stage-1.css?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc" rel="stylesheet">
<link href="../../static/kunai/css/kunai-stage-2.css?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc" rel="stylesheet">
<link href="../../static/kunai/css/kunai-stage-3.css?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc" rel="stylesheet">
<script type="text/javascript" src="../../static/kunai/js/kunai-vendor.js?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc"></script>
<script type="text/javascript" src="../../static/kunai/js/kunai.js?cachebust=557cd0469f26f0f797224f46d1b6e764266f07cc"></script>
<script type="text/javascript">
  document.addEventListener('DOMContentLoaded', function() {
    var kn = new Kunai;
    kn.cpprefjp();
    </head>
<header data-kunai-mdinfo="{&#34;meta&#34;: {&#34;header&#34;: [&#34;memory&#34;], &#34;namespace&#34;: [&#34;std&#34;], &#34;id-type&#34;: [&#34;class template&#34;], &#34;cpp&#34;: [&#34;cpp11&#34;]}, &#34;sources&#34;: [{&#34;id&#34;: &#34;9f1ccaa9953285375d8431b59c1bf44e1fddf3de&#34;, &#34;source&#34;: &#34;#include &lt;iostream&gt;\n#include &lt;memory&gt;\n\nint main()\n{\n  // new\u3057\u305f\u30dd\u30a4\u30f3\u30bf\u3092shared_ptr\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u306b\u7ba1\u7406\u3055\u305b\u308b\n  // \u6240\u6709\u8005\u306f1\u4eba\u3002\n  std::shared_ptr&lt;int&gt; p1(new int(3));\n\n  {\n    // shared_ptr\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3092\u30b3\u30d4\u30fc\u3059\u308b\u3053\u3068\u3067\u3001\n    // \u8907\u6570\u306e\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u304c\u4e00\u3064\u306e\u30ea\u30bd\u30fc\u30b9\u3092\u5171\u6709\u3067\u304d\u308b\u3002\n    // \u6240\u6709\u8005\u304c2\u4eba\u306b\u306a\u308b\u3002\n    std::shared_ptr&lt;int&gt; p2 = p1;\n\n    // \u5171\u6709\u3057\u3066\u3044\u308b\u30ea\u30bd\u30fc\u30b9\u306b\u30a2\u30af\u30bb\u30b9\u3059\u308b\n    std::cout &lt;&lt; *p2 &lt;&lt; std::endl;\n  } // p2\u306e\u30c7\u30b9\u30c8\u30e9\u30af\u30bf\u304c\u5b9f\u884c\u3055\u308c\u308b\u3002\n    // \u30ea\u30bd\u30fc\u30b9\u306e\u6240\u6709\u8005\u304c1\u4eba\u306b\u306a\u308b\u3002\n    // \u3053\u3053\u3067\u306f\u307e\u3060\u3001\u30ea\u30bd\u30fc\u30b9\u306f\u89e3\u653e\u3055\u308c\u306a\u3044\u3002\n\n  std::cout &lt;&lt; *p1 &lt;&lt; std::endl;\n} // p1\u306e\u30c7\u30b9\u30c8\u30e9\u30af\u30bf\u304c\u5b9f\u884c\u3055\u308c\u308b\u3002\n  // \u30ea\u30bd\u30fc\u30b9\u306e\u6240\u6709\u8005\u304c0\u4eba\u306b\u306a\u308b\u3002\n  // \u8ab0\u3082\u30ea\u30bd\u30fc\u30b9\u3092\u53c2\u7167\u3057\u306a\u304f\u306a\u3063\u305f\u306e\u3067\u3001\u30ea\u30bd\u30fc\u30b9\u304c\u89e3\u653e\u3055\u308c\u308b\u3002\n&#34;}, {&#34;id&#34;: &#34;664f6985d9fe71095bb43a9e050b45f85946471a&#34;, &#34;source&#34;: &#34;#include &lt;iostream&gt;\n#include &lt;memory&gt;\n\nstruct X {\n  ~X()\n  {\n    std::cout &lt;&lt; \&#34;X dtor\&#34; &lt;&lt; std::endl;\n  }\n};\n\nstruct Y {\n  ~Y()\n  {\n    std::cout &lt;&lt; \&#34;Y dtor\&#34; &lt;&lt; std::endl;\n  }\n};\n\nint main()\n{\n  std::shared_ptr&lt;void&gt; p(new X());\n\n  std::cout &lt;&lt; 0 &lt;&lt; std::endl;\n\n  p.reset(new Y()); // X\u304c\u7834\u68c4\u3055\u308c\u308b\n\n  std::cout &lt;&lt; 1 &lt;&lt; std::endl;\n} // Y\u304c\u7834\u68c4\u3055\u308c\u308b\n&#34;}], &#34;page_id&#34;: [&#34;reference&#34;, &#34;memory&#34;, &#34;shared_ptr&#34;]}">
  <nav class="navbar navbar-default" role="navigation">
    <div class="container-fluid">
      <div class="navbar-header">
        <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar-collapse">
          <span class="sr-only">Toggle navigation</span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
        </button>
        <a class="navbar-brand" href="../../index.html">
          <div class="title-wrapper clearfix">
            <div class="title">cpprefjp - C++日本語リファレンス</div>
          </div>
        </a>
      </div>
      <div class="collapse navbar-collapse" id="navbar-collapse">
        <ul class="nav navbar-nav navbar-right">
          <li>
            <div class="google-search">
  (function() {
    var cx = '013316413321391058734:ji_u66hl7hq';
    var gcse = document.createElement('script');
    gcse.type = 'text/javascript';
    gcse.async = true;
    gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') +
        '//www.google.com/cse/cse.js?cx=' + cx;
    var s = document.getElementsByTagName('script')[0];
    s.parentNode.insertBefore(gcse, s);
<div class="gcse-search"></div>
            </div>
          </li>
          <li>
  <a href="https://github.com/cpprefjp/site">GitHub Project</a>
        </ul>
      </div>
        <main id="main" role="main">
            <div class="container-fluid">
<div class="row">
  <div class="col-sm-9 col-sm-push-3" itemscope itemtype="http://schema.org/Article">
    <div class="row">
      <div class="col-sm-12 google-search-result">
        <gcse:searchresults></gcse:searchresults>
      </div>
    <div class="row">
      <div class="col-sm-12 content-header">
  <ol class="breadcrumb">
      <li  itemscope itemtype="http://www.schema.org/SiteNavigationElement">
        <span>
            <a href="../../index.html" itemprop="url">
                <i class="fa fa-fw fa-home"></i>
            </a>
        </span>
      </li>
      <li  itemscope itemtype="http://www.schema.org/SiteNavigationElement">
        <span>
            <a href="../../reference.html" itemprop="url">
                <span itemprop="name">リファレンス</span>
            </a>
        </span>
      </li>
      <li  itemscope itemtype="http://www.schema.org/SiteNavigationElement">
        <span>
            <a href="../../reference/memory.html" itemprop="url">
                <span itemprop="name">memory</span>
            </a>
        </span>
      </li>
      <li class="active" itemscope itemtype="http://www.schema.org/SiteNavigationElement">
        <span>
              <span itemprop="name">shared_ptr</span>
        </span>
      </li>
  <div class="crsearch"></div>
      </div>
    <div class="row">
      <div class="col-sm-12 edit-button">
    <p class="text-right"><small>
      最終更新日時:
      <time itemprop="datePublished" class="js-local-time"
            datetime="2026-02-25T13:06:35+09:00">
        2026年02月25日 13時06分35秒 (JST)
      </time>
      <br/>
      <span itemprop="author" itemscope itemtype="http://schema.org/Person">
        <span itemprop="name">Akira Takahashi</span>
      </span>
    </small></p>
    <script>
    (function () {
      // 最終更新日時を閲覧者のローカルタイムゾーンで表示し直す (issue #53 の正規化)。
      // JS が無効な環境ではサーバ生成の JST 表記がそのまま残る。
      function pad(n) { return (n < 10 ? '0' : '') + n; }
      var els = document.querySelectorAll('time.js-local-time[datetime]');
      for (var i = 0; i < els.length; i++) {
        var el = els[i];
        var d = new Date(el.getAttribute('datetime'));
        if (isNaN(d.getTime())) { continue; }
        var tz = '';
        try {
          var parts = new Intl.DateTimeFormat(undefined, { timeZoneName: 'short' }).formatToParts(d);
          for (var j = 0; j < parts.length; j++) {
            if (parts[j].type === 'timeZoneName') { tz = parts[j].value; break; }
        } catch (e) {}
        el.textContent = d.getFullYear() + '年' + pad(d.getMonth() + 1) + '月' + pad(d.getDate()) + '日 '
          + pad(d.getHours()) + '時' + pad(d.getMinutes()) + '分' + pad(d.getSeconds()) + '秒'
          + (tz ? ' (' + tz + ')' : '');
    </script>
        <p class="text-right">
          <a class="history" target="_blank" href="https://github.com/cpprefjp/site/commits/master/reference/memory/shared_ptr.md">
            <span class="fa fa-fw fa-clock-o fa-flip-horizontal"></span>履歴
          </a>
          <a class="edit" target="_blank" href="https://github.com/cpprefjp/site/edit/master/reference/memory/shared_ptr.md">
            <span class="fa fa-fw fa-pencil"></span>編集
          </a>
        </p>
      </div>
    <div class="row">
      <div class="col-sm-12 content-body">
  <div class="identifier-type">class template</div><div class="header">&lt;memory&gt;</div><h1 itemprop="name"><span class="namespace" title="namespace std">std::</span><span class="token">shared_ptr</span><span class="cpp cpp11" title="C++11で追加">(C++11)</span></h1>
<div itemprop="articleBody"><p><div class="codehilite"><pre><span></span><code><span class="k">namespace</span><span class="w"> </span><span class="nn">std</span><span class="w"> </span><span class="p">{</span>
<span class="w">  </span><span class="k">template</span><span class="w"> </span><span class="o">&lt;</span><span class="k">class</span><span class="w"> </span><span class="nc">T</span><span class="o">&gt;</span>
<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">shared_ptr</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div>
<h2>概要</h2>
<p><code>shared_ptr</code>は、指定されたリソースへの所有権(ownership)を共有(share)するスマートポインタである。</p>
<p>複数の<code>shared_ptr</code>オブジェクトが同じリソースを共有し、所有者が0人、つまりどの<code>shared_ptr</code>オブジェクトからもリソースが参照されなくなると、リソースが自動的に解放される。</p>
<h3>参照カウント</h3>
<p><code>shared_ptr</code>は「参照カウント(reference count)」によって実装される。</p>
<p><code>shared_ptr</code>オブジェクトのコピー構築、コピー代入が行われるとカウントが1増える。デストラクタが実行されるとカウントが1減る。そしてカウントが0になると、自動的に「<code>delete p;</code>」が実行され、リソースが解放される。</p>
<h3>スレッド安全性</h3>
<p><code>shared_ptr</code>の参照カウンタはスレッドセーフである。つまり、スレッドを跨いで<code>shared_ptr</code>をコピーし、リソースを共有することが安全にできる。</p>
<p>非スレッドセーフに参照カウントを増減させる方法はない。シングルスレッドでのパフォーマンスが重要で、スレッドセーフであることによるオーバーヘッドが問題になる場合、ムーブを活用すればパフォーマンスを改善できる。</p>
<h2>メンバ関数</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
<td><code><a href="shared_ptr/op_constructor.html">(constructor)</a></code></td>
<td>コンストラクタ</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_destructor.html">(destructor)</a></code></td>
<td>デストラクタ</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_assign.html">operator=</a></code></td>
<td>代入演算子</td>
<td>C++11</td>
<td><code><a href="shared_ptr/reset.html">reset</a></code></td>
<td>所有権を放棄し、新たな所有権を設定する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/swap.html">swap</a></code></td>
<td>他の<code>shared_ptr</code>オブジェクトとデータを入れ替える</td>
<td>C++11</td>
<td><code><a href="shared_ptr/get.html">get</a></code></td>
<td>リソースを取得する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_deref.html">operator*</a></code></td>
<td>間接参照</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_arrow.html">operator-&gt;</a></code></td>
<td>メンバアクセス</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_at.html">operator[]</a></code></td>
<td>添字による要素アクセス</td>
<td>C++17</td>
<td><code><a href="shared_ptr/use_count.html">use_count</a></code></td>
<td>所有権を持つユーザー数を取得する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/unique.html">unique</a></code></td>
<td>所有権を持つユーザーが一人だけかを判定する</td>
<td>C++11<br /> C++17から非推奨<br /> C++20で削除</td>
<td><code><a href="shared_ptr/op_bool.html">operator bool</a></code></td>
<td>有効なリソースを所有しているかを判定する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/owner_before.html">owner_before</a></code></td>
<td>所有権ベースでの小なり比較を行う</td>
<td>C++11</td>
<td><code><a href="shared_ptr/owner_equal.html">owner_equal</a></code></td>
<td>所有権ベースでの等値比較を行う</td>
<td>C++26</td>
<td><code><a href="shared_ptr/owner_hash.html">owner_hash</a></code></td>
<td>所有権ベースでのハッシュ値を取得する</td>
<td>C++26</td>
<h2>メンバ型</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
<td><code>element_type</code></td>
<td>管理するインスタンスの型<br /> C++11 : <code>T</code><br /> C++17 : <code><a href="../type_traits/remove_extent.html">remove_extent_t</a>&lt;T&gt;</code></td>
<td>C++11</td>
<td><code>weak_type</code></td>
<td>弱参照ポインタの型<code><a href="weak_ptr.html">weak_ptr</a>&lt;T&gt;</code></td>
<td>C++17</td>
<h2>非メンバ関数</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
<td><code><a href="shared_ptr/op_equal.html">operator==</a></code></td>
<td>等値比較</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_not_equal.html">operator!=</a></code></td>
<td>非等値比較</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_compare_3way.html">operator&lt;=&gt;</a></code></td>
<td>三方比較</td>
<td>C++20</td>
<td><code><a href="shared_ptr/op_less.html">operator&lt;</a></code></td>
<td>左辺が右辺より小さいかを判定する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_less_equal.html">operator&lt;=</a></code></td>
<td>左辺が右辺以下かを判定する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_greater.html">operator&gt;</a></code></td>
<td>左辺が右辺より大きいかを判定する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_greater_equal.html">operator&gt;=</a></code></td>
<td>左辺が右辺以上かを判定する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/swap_free.html">swap</a></code></td>
<td>2つの<code>shared_ptr</code>オブジェクトを入れ替える</td>
<td>C++11</td>
<td><code><a href="shared_ptr/get_deleter.html">get_deleter</a></code></td>
<td>デリータを取得する</td>
<td>C++11</td>
<td><code><a href="shared_ptr/op_ostream.html">operator&lt;&lt;</a></code></td>
<td>ストリームへの出力</td>
<td>C++11</td>
<td><code><a href="shared_ptr/static_pointer_cast.html">static_pointer_cast</a></code></td>
<td><code>shared_ptr</code>の静的キャスト</td>
<td>C++11</td>
<td><code><a href="shared_ptr/dynamic_pointer_cast.html">dynamic_pointer_cast</a></code></td>
<td><code>shared_ptr</code>の動的キャスト</td>
<td>C++11</td>
<td><code><a href="shared_ptr/const_pointer_cast.html">const_pointer_cast</a></code></td>
<td><code>shared_ptr</code>の<code>const</code>修飾キャスト</td>
<td>C++11</td>
<td><code><a href="shared_ptr/reinterpret_pointer_cast.html">reinterpret_pointer_cast</a></code></td>
<td><code>shared_ptr</code>の再解釈キャスト</td>
<td>C++17</td>
<td><code><a href="make_shared.html">make_shared</a></code></td>
<td><code>shared_ptr</code>を構築するヘルパ関数</td>
<td>C++11</td>
<td><code><a href="allocate_shared.html">allocate_shared</a></code></td>
<td>アロケータを指定して<code>shared_ptr</code>を構築するヘルパ関数</td>
<td>C++11</td>
<h2>アトミックアクセス(非メンバ関数)</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
<td><code><a href="shared_ptr/atomic_is_lock_free.html">atomic_is_lock_free</a></code></td>
<td>指定されたオブジェクトがロックフリーに振る舞えるかを調べる</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_store.html">atomic_store</a></code></td>
<td>値を書き込む</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_store_explicit.html">atomic_store_explicit</a></code></td>
<td>メモリオーダーを指定して値を書き込む</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_load.html">atomic_load</a></code></td>
<td>値を読み込む</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_load_explicit.html">atomic_load_explicit</a></code></td>
<td>メモリオーダーを指定して値を読み込む</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_exchange.html">atomic_exchange</a></code></td>
<td>値を入れ替える</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_exchange_explicit.html">atomic_exchange_explicit</a></code></td>
<td>メモリオーダーを指定して値を入れ替える</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_compare_exchange_weak.html">atomic_compare_exchange_weak</a></code></td>
<td>弱い比較で値の入れ替えを行う</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_compare_exchange_strong.html">atomic_compare_exchange_strong</a></code></td>
<td>強い比較で値の入れ替えを行う</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_compare_exchange_weak_explicit.html">atomic_compare_exchange_weak_explicit</a></code></td>
<td>弱い比較でメモリオーダーを指定して値の入れ替えを行う</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<td><code><a href="shared_ptr/atomic_compare_exchange_strong_explicit.html">atomic_compare_exchange_strong_explicit</a></code></td>
<td>強い比較でメモリオーダーを指定して値の入れ替えを行う</td>
<td>C++11<br /> C++20から非推奨<br /> C++26で削除</td>
<h2>ハッシュサポート</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
<td><code>template &lt;class T&gt; struct hash;</code></td>
<td><code>hash</code>クラスの先行宣言</td>
<td>C++11</td>
<td><code>template &lt;class T&gt; struct hash&lt;shared_ptr&lt;T&gt;&gt;;</code></td>
<td><code>hash</code>クラスの<code>shared_ptr</code>に対する特殊化</td>
<td>C++11</td>
<h2>推論補助</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
<td><code><a href="shared_ptr/op_deduction_guide.html">(deduction_guide)</a></code></td>
<td>クラステンプレートの推論補助</td>
<td>C++17</td>
<h3>shared_ptrの基本的な使い方</h3>
<p><div class="yata" id="9f1ccaa9953285375d8431b59c1bf44e1fddf3de"><div class="codehilite"><pre><span></span><code><span class="cp">#include <a href="../iostream.html">&lt;iostream&gt;</a></span>
<span class="cp">#include <a href="../memory.html">&lt;memory&gt;</a></span>
<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span>
<span class="p">{</span>
<span class="w">  </span><span class="c1">// newしたポインタをshared_ptrオブジェクトに管理させる</span>
<span class="w">  </span><span class="c1">// 所有者は1人。</span>
<span class="w">  </span><span class="n"><span style="color:#ff0000">std::shared_ptr</span></span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="n">p1</span><span class="p">(</span><span class="k">new</span><span class="w"> </span><span class="kt">int</span><span class="p">(</span><span class="mi">3</span><span class="p">));</span>
<span class="w">  </span><span class="p">{</span>
<span class="w">    </span><span class="c1">// shared_ptrオブジェクトをコピーすることで、</span>
<span class="w">    </span><span class="c1">// 複数のオブジェクトが一つのリソースを共有できる。</span>
<span class="w">    </span><span class="c1">// 所有者が2人になる。</span>
<span class="w">    </span><span class="n"><span style="color:#ff0000">std::shared_ptr</span></span><span class="o">&lt;</span><span class="kt">int</span><span class="o">&gt;</span><span class="w"> </span><span class="n">p2</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">p1</span><span class="p">;</span>
<span class="w">    </span><span class="c1">// 共有しているリソースにアクセスする</span>
<span class="w">    </span><span class="n"><a href="../iostream/cout.html">std::cout</a></span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="o">*</span><span class="n">p2</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n"><a href="../ostream/endl.html">std::endl</a></span><span class="p">;</span>
<span class="w">  </span><span class="p">}</span><span class="w"> </span><span class="c1">// p2のデストラクタが実行される。</span>
<span class="w">    </span><span class="c1">// リソースの所有者が1人になる。</span>
<span class="w">    </span><span class="c1">// ここではまだ、リソースは解放されない。</span>
<span class="w">  </span><span class="n"><a href="../iostream/cout.html">std::cout</a></span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="o">*</span><span class="n">p1</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n"><a href="../ostream/endl.html">std::endl</a></span><span class="p">;</span>
<span class="p">}</span><span class="w"> </span><span class="c1">// p1のデストラクタが実行される。</span>
<span class="w">  </span><span class="c1">// リソースの所有者が0人になる。</span>
<span class="w">  </span><span class="c1">// 誰もリソースを参照しなくなったので、リソースが解放される。</span>
</code></pre></div>
<h4>出力</h4>
<p><pre><code>3
</code></pre></p>
<h3>shared_ptr&lt;void&gt;に、あらゆる型のポインタを格納する</h3>
<p><code>void</code>をテンプレート引数とする<code>shared_ptr</code>に対してどんな型のポインタを代入したとしても、代入した型のデストラクタは、正しく実行される。通常、<code>void*</code>に型変換して代入されたポインタは、<code>delete</code>演算子を呼んだとしても元の型のデストラクタは呼び出されない。しかし<code>shared_ptr</code>の場合は、代入されたポインタの型が持つデストラクタが正しく実行されることが保証される。保証の文面は<a href="shared_ptr/op_destructor.html">デストラクタ</a>のページを参照。</p>
<p><div class="yata" id="664f6985d9fe71095bb43a9e050b45f85946471a"><div class="codehilite"><pre><span></span><code><span class="cp">#include <a href="../iostream.html">&lt;iostream&gt;</a></span>
<span class="cp">#include <a href="../memory.html">&lt;memory&gt;</a></span>
<span class="k">struct</span><span class="w"> </span><span class="nc">X</span><span class="w"> </span><span class="p">{</span>
<span class="w">  </span><span class="o">~</span><span class="n">X</span><span class="p">()</span>
<span class="w">  </span><span class="p">{</span>
<span class="w">    </span><span class="n"><a href="../iostream/cout.html">std::cout</a></span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">"X dtor"</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n"><a href="../ostream/endl.html">std::endl</a></span><span class="p">;</span>
<span class="w">  </span><span class="p">}</span>
<span class="p">};</span>
<span class="k">struct</span><span class="w"> </span><span class="nc">Y</span><span class="w"> </span><span class="p">{</span>
<span class="w">  </span><span class="o">~</span><span class="n">Y</span><span class="p">()</span>
<span class="w">  </span><span class="p">{</span>
<span class="w">    </span><span class="n"><a href="../iostream/cout.html">std::cout</a></span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="s">"Y dtor"</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n"><a href="../ostream/endl.html">std::endl</a></span><span class="p">;</span>
<span class="w">  </span><span class="p">}</span>
<span class="p">};</span>
<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span>
<span class="p">{</span>
<span class="w">  </span><span class="n"><span style="color:#ff0000">std::shared_ptr</span></span><span class="o">&lt;</span><span class="kt">void</span><span class="o">&gt;</span><span class="w"> </span><span class="n">p</span><span class="p">(</span><span class="k">new</span><span class="w"> </span><span class="n">X</span><span class="p">());</span>
<span class="w">  </span><span class="n"><a href="../iostream/cout.html">std::cout</a></span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="mi">0</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n"><a href="../ostream/endl.html">std::endl</a></span><span class="p">;</span>
<span class="w">  </span><span class="n">p</span><span class="p">.</span><span class="n">reset</span><span class="p">(</span><span class="k">new</span><span class="w"> </span><span class="n">Y</span><span class="p">());</span><span class="w"> </span><span class="c1">// Xが破棄される</span>
<span class="w">  </span><span class="n"><a href="../iostream/cout.html">std::cout</a></span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="mi">1</span><span class="w"> </span><span class="o">&lt;&lt;</span><span class="w"> </span><span class="n"><a href="../ostream/endl.html">std::endl</a></span><span class="p">;</span>
<span class="p">}</span><span class="w"> </span><span class="c1">// Yが破棄される</span>
</code></pre></div>
<h3>出力</h3>
<p><pre><code>0
</code></pre></p>
<h2>バージョン</h2>
<h3>言語</h3>
<li>C++11</li>
<h3>処理系</h3>
<li><a href="../../implementation.html#clang">Clang</a>: 3.0 <span aria-label="検証済" role="img" title="検証済">✅</span></li>
<li><a href="../../implementation.html#gcc">GCC</a>: 4.3.6 <span aria-label="検証済" role="img" title="検証済">✅</span></li>
<li><a href="../../implementation.html#icc">ICC</a>: ??</li>
<li><a href="../../implementation.html#visual_cpp">Visual C++</a>: 2008 (TR1) <span aria-label="検証済" role="img" title="検証済">✅</span>, 2010 <span aria-label="検証済" role="img" title="検証済">✅</span>, 2012 <span aria-label="検証済" role="img" title="検証済">✅</span>, 2013 <span aria-label="検証済" role="img" title="検証済">✅</span></li>
<h2>関連項目</h2>
<li><code><a href="enable_shared_from_this.html">std::enable_shared_from_this</a></code><ul>
<li><code>this</code>ポインタを<code>shared_ptr</code>として使用する場合は、この機能を使用する</li>
<li><code><a href="unique_ptr.html">std::unique_ptr</a></code><ul>
<li>所有権を共有する必要がない場合は、この機能を使用する</li>
<h2>参照</h2>
<li><a href="http://d.hatena.ne.jp/Cryolite/20060108#p1" target="_blank">動的削除子 (dynamic deleter) - 意外と知られていない？ <code>boost::shared_ptr</code> の側面</a></li>
<li><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/p0163r0.html" target="_blank">P0163R0 <code>shared_ptr::weak_type</code></a></li>
<li><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0414r1.html" target="_blank">P0414R1 Merging <code>shared_ptr</code> changes from Library Fundamentals to C++17</a></li>
<li><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2018/p0619r4.html" target="_blank">P0619R4 Reviewing deprecated facilities of C++17 for C++20</a></li>
</ul></div>
      </div>
    <div id="sidebar" class="col-sm-3 col-sm-pull-9">
            </div>
        </main>
<footer class="footer navbar navbar-default">
  <div class="container-fluid">
    <p><small>
      本サイトの情報は、
        <a href="https://creativecommons.org/licenses/by/4.0/deed.ja" rel="nofollow">クリエイティブ・コモンズ 表示 4.0 非移植 ライセンス(CC BY)</a>
      の下に提供されています。
    </small></p>
    </body>
Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

shared_ptr.html

Latest commit

History

shared_ptr.html

File metadata and controls
