pool_resource.html

<!doctype html>
<html class="cpprefjp" lang="ja" itemscope="" itemtype="http://schema.org/WebPage">
    <head>
        
  
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-NXNBNVBTJS"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'G-NXNBNVBTJS');
</script>


        <meta charset="UTF-8">

        <title>std::pmr::pool_resource - cpprefjp C++日本語リファレンス</title>

        <meta name="viewport" content="width=device-width,initial-scale=1">
        <meta name="keywords" content="
  C++,標準ライブラリ,リファレンス,ドキュメント,STL,std,memory_resource,class,std::pmr,cpp17
">
        <meta name="title" content="std::pmr::pool_resource - cpprefjp C++日本語リファレンス" />
        <meta itemprop="name" content="std::pmr::pool_resource - cpprefjp C++日本語リファレンス" />
        <meta property="og:title" content="std::pmr::pool_resource - cpprefjp C++日本語リファレンス" />
        <meta property="og:url" content="https://cpprefjp.github.io/reference/memory_resource/pool_resource.html" />
        <meta property="og:site_name" content="cpprefjp - C++日本語リファレンス" />
        <meta property="og:type" content="article" />
        <meta property="og:description" content="`pool_resource`は幾つかのブロックサイズ毎のメモリプールを管理し、要求サイズ毎に最適なプールからメモリを割り当てる[`memory_resource`](memory_resource.md)実装である。  " />
        <meta property="og:image" content="" />
        <meta name="twitter:card" content="summary" />
        <meta name="twitter:title" content="std::pmr::pool_resource - cpprefjp C++日本語リファレンス" />
        <meta name="twitter:url" content="https://cpprefjp.github.io/reference/memory_resource/pool_resource.html" />
        <meta name="twitter:description" content="`pool_resource`は幾つかのブロックサイズ毎のメモリプールを管理し、要求サイズ毎に最適なプールからメモリを割り当てる[`memory_resource`](memory_resource.md)実装である。  " />
        <meta name="twitter:image" content="" />

        
  <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=807374ab51c48a5ce84749cf2ad281ba69eb3e58">
<link rel="icon" type="image/png" sizes="32x32" href="../../static/favicons/favicon-32x32.png?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58">
<link rel="icon" type="image/png" sizes="16x16" href="../../static/favicons/favicon-16x16.png?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58">
<link rel="manifest" href="../../manifest.json?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58">
<meta name="theme-color" content="#f5f8fc">

<link rel="stylesheet" href="../../static/pygments/default.css?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58">
<!-- <link rel="stylesheet" href="../../static/css/root.css"> -->

        
  


<link href="../../static/kunai/css/kunai-stage-0.css?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58" rel="stylesheet">
<link href="../../static/kunai/css/kunai-stage-1.css?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58" rel="stylesheet">
<link href="../../static/kunai/css/kunai-stage-2.css?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58" rel="stylesheet">
<link href="../../static/kunai/css/kunai-stage-3.css?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58" rel="stylesheet">

<script type="text/javascript" src="../../static/kunai/js/kunai-vendor.js?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58"></script>
<script type="text/javascript" src="../../static/kunai/js/kunai.js?cachebust=807374ab51c48a5ce84749cf2ad281ba69eb3e58"></script>

<script type="text/javascript">
  document.addEventListener('DOMContentLoaded', function() {
    var kn = new Kunai;
    kn.cpprefjp();
  });
</script>

    </head>
    <body>
<header data-kunai-mdinfo="{&#34;meta&#34;: {&#34;header&#34;: [&#34;memory_resource&#34;], &#34;id-type&#34;: [&#34;class&#34;], &#34;namespace&#34;: [&#34;std::pmr&#34;], &#34;cpp&#34;: [&#34;cpp17&#34;]}, &#34;sources&#34;: [], &#34;page_id&#34;: [&#34;reference&#34;, &#34;memory_resource&#34;, &#34;pool_resource&#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">
              
  
<script>
  (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);
  })();
</script>
<div class="gcse-search"></div>


            </div>
          </li>
          <li>
  <a href="https://github.com/cpprefjp/site">GitHub Project</a>
</li>
        </ul>
      </div>
    </div>
  </nav>
</header>

        <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>
    <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_resource.html" itemprop="url">
              
                <span itemprop="name">memory_resource</span>
              
            </a>
          
        </span>
      </li>
    
      <li class="active" itemscope itemtype="http://www.schema.org/SiteNavigationElement">
        <span>
          
            
              <span itemprop="name">pool_resource</span>
            
          
        </span>
      </li>
    
  </ol>
  <div class="crsearch"></div>

      </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="2024-06-11T22:45:38+09:00">
        2024年06月11日 22時45分38秒 (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_resource/pool_resource.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_resource/pool_resource.md">
            <span class="fa fa-fw fa-pencil"></span>編集
          </a>
        </p>
      </div>
    </div>
    <div class="row">
      <div class="col-sm-12 content-body">
        
  <div class="identifier-type">class</div><div class="header">&lt;memory_resource&gt;</div><h1 itemprop="name"><span class="namespace" title="namespace std::pmr">std::pmr::</span><span class="token">pool_resource</span><span class="cpp cpp17" title="C++17で追加">(C++17)</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="o">::</span><span class="nn">pmr</span><span class="w"> </span><span class="p">{</span>
<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">synchronized_pool_resource</span><span class="p">;</span>
<span class="w">  </span><span class="k">class</span><span class="w"> </span><span class="nc">unsynchronized_pool_resource</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div>
</p>
<h2>概要</h2>
<p><code>pool_resource</code>は幾つかのブロックサイズ毎のメモリプールを管理し、要求サイズ毎に最適なプールからメモリを割り当てる<code><a href="memory_resource.html">memory_resource</a></code>実装である。<br />
メモリ割り当て要求に内部のメモリプールから応えられない場合（最大のブロックサイズを超える要求があった場合）は、上流のメモリリソースからメモリを割り当てる。ほとんどの場合、上流メモリリソースへの割り当て要求は内部プールへの割り当て要求よりも少ない。</p>
<p>以下2つの<code>pool_resource</code>が提供される。</p>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<thead>
<tr>
<th><code>pool_resource</code>クラス名</th>
<th>説明</th>
<th>対応バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>synchronized_pool_resource</code></td>
<td>スレッドセーフな<code>pool_resource</code></td>
<td>C++17</td>
</tr>
<tr>
<td><code>unsynchronized_pool_resource</code></td>
<td>スレッドセーフでない<code>pool_resource</code></td>
<td>C++17</td>
</tr>
</tbody>
</table>
<p><code>synchronized_pool_resource</code>は外部同期機構無しで複数のスレッドからスレッドセーフにアクセスできる。<br />
実装によっては同期コストの削減のためにスレッド毎にメモリプールを持つ可能性がある。</p>
<p><code>unsynchronized_pool_resource</code>は複数スレッドからアクセスした際にスレッドセーフ性が保証されないが、シングルスレッドで使用する場合に同期のためのオーバーヘッドを避けることができる。</p>
<h2><code>pool_resource</code>の性質</h2>
<ul>
<li>内部管理メモリ領域は様々なブロックサイズのメモリプールに分かれている。</li>
<li>それぞれのブロックサイズ毎のメモリプールは幾つかのチャンクの集まりであり、各チャンクは均一なサイズ（ブロックサイズ）のブロックに順番に分割されている。</li>
<li><code>do_allocate</code>によって返されるメモリはブロック単位で割り当てられる。</li>
<li><code>do_allocate(bytes, alignment)</code>は、<code>bytes</code>以上で最小のブロックサイズのプールからメモリを割り当てる。<ul>
<li><code>bytes</code>が最大ブロックサイズを超える場合、上流メモリリソースから直接割り当てられる。</li>
</ul>
</li>
<li>あるプールが枯渇した場合、次の<code>do_allocate</code>時に上流メモリリソースからチャンク単位でプールを補充する。<ul>
<li>補充の度に補充されるチャンクサイズは等比数列に従って増加する（上限有）。</li>
<li>一定のチャンク毎に補充を行うことで連続した割り当てにおける参照局所性を高める狙いがある。</li>
</ul>
</li>
<li>最大チャンクサイズ及び最大ブロックサイズは<code><a href="pool_options.html">pool_options</a></code>構造体をコンストラクタに渡して調整可能。<ul>
<li><code>max_blocks_per_chunk</code> : チャンクサイズの上限値、この値よりは大きくならない</li>
<li><code>largest_required_pool_block</code> : ブロックサイズの最大値、この値を超える割り当て要求は上流メモリリソースから直接割り当てる</li>
</ul>
</li>
<li>管理メモリの解放時は<code>deallocate</code>が呼び出されていない領域があっても全てのメモリを解放する。</li>
</ul>
<h2>メンバ関数</h2>
<h3>構築・破棄</h3>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<thead>
<tr>
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td><code><a href="pool_resource/op_constructor.html">(constructor)</a></code></td>
<td>コンストラクタ</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="pool_resource/op_destructor.html">(destructor)</a></code></td>
<td>デストラクタ</td>
<td>C++17</td>
</tr>
<tr>
<td><code>operator=(const pool_resource&amp;) = delete;</code></td>
<td>コピー代入演算子（コピー禁止）</td>
<td>C++17</td>
</tr>
</tbody>
</table>
<p>クラス名を<code>pool_resource</code>としているのは説明のためのプレースホルダで、<code>synchronized_pool_resource</code>と<code>unsynchronized_pool_resource</code>で共通ということである。</p>
<h3>共通メンバ関数</h3>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<thead>
<tr>
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td><code><a href="pool_resource/release.html">release</a></code></td>
<td>割り当てられている全てのメモリを解放する</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="pool_resource/upstream_resource.html">upstream_resource</a></code></td>
<td>利用している上流<code>memory_resource</code>を取得する</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="pool_resource/options.html">options</a></code></td>
<td>適用されているプール設定を<code>pool_options</code>として取得する</td>
<td>C++17</td>
</tr>
</tbody>
</table>
<h3>非仮想インターフェース（NVI）</h3>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<thead>
<tr>
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td><code><a href="memory_resource/allocate.html">allocate</a></code></td>
<td>メモリを確保する</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="memory_resource/deallocate.html">deallocate</a></code></td>
<td>メモリを解放する</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="memory_resource/is_equal.html">is_equal</a></code></td>
<td>オブジェクトを超えてメモリ領域の解放を行えるかを調べる</td>
<td>C++17</td>
</tr>
</tbody>
</table>
<h3>protected オーバーライド関数</h3>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<thead>
<tr>
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td><code><a href="pool_resource/do_allocate.html">do_allocate</a></code></td>
<td>メモリを確保する</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="pool_resource/do_deallocate.html">do_deallocate</a></code></td>
<td>メモリを解放する</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="pool_resource/do_is_equal.html">do_is_equal</a></code></td>
<td>オブジェクトを超えてメモリ領域の解放を行えるかを調べる</td>
<td>C++17</td>
</tr>
</tbody>
</table>
<h2>非メンバ関数</h2>
<table border="1" bordercolor="#888" style="border-collapse:collapse">
<thead>
<tr>
<th>名前</th>
<th>説明</th>
<th>対応バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td><code><a href="memory_resource/op_equal.html">operator==</a></code></td>
<td>等値比較</td>
<td>C++17</td>
</tr>
<tr>
<td><code><a href="memory_resource/op_not_equal.html">operator!=</a></code></td>
<td>非等値比較</td>
<td>C++17</td>
</tr>
</tbody>
</table>
<h2><code>synchronized_pool_resource</code>の処理系毎の実装</h2>
<h3>MSVC 2017, 2019</h3>
<p><code>unsynchronized_pool_resource</code>を継承し、アクセスを<code><a href="../mutex/mutex.html">mutex</a></code>で同期させている。<br />
スレッド毎にプールを持たない。</p>
<h3>GCC 9.1</h3>
<p>スレッド毎にプールを持ち、各プールはリンクリストで管理されている。</p>
<h2>バージョン</h2>
<h3>言語</h3>
<ul>
<li>C++17</li>
</ul>
<h3>処理系</h3>
<ul>
<li><a href="../../implementation.html#clang">Clang</a>: ??</li>
<li><a href="../../implementation.html#gcc">GCC</a>: 9.1 <span aria-label="検証済" role="img" title="検証済">✅</span></li>
<li><a href="../../implementation.html#visual_cpp">Visual C++</a>: 2017 update 6 <span aria-label="検証済" role="img" title="検証済">✅</span></li>
</ul>
<h2>関連項目</h2>
<ul>
<li><code><a href="pool_options.html">pool_options</a></code></li>
<li><code><a href="memory_resource.html">memory_resource</a></code></li>
</ul>
<h2>参照</h2>
<ul>
<li><a href="https://faithandbrave.hateblo.jp/entry/2016/08/08/170454" target="_blank">C++1z 多相アロケータとメモリプール - Faith and Brave - C++で遊ぼう </a></li>
<li><a href="https://cpplover.blogspot.com/2015/09/memoryresource.html" target="_blank">memory_resourceについて - 本の虫</a></li>
<li><a href="https://qiita.com/MitsutakaTakeda/items/48980faa9498c46b15b2" target="_blank">Polymorphic Allocator in C++17 - Qita</a></li>
<li><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0220r1.html" target="_blank">P0220R1 Adopt Library Fundamentals V1 TS Components for C++17 (R1)</a></li>
<li><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0337r0.html" target="_blank">P0337r0 | Delete operator= for polymorphic_allocator</a></li>
<li><a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2015/n4562.html#memory.resource.synop" target="_blank">Working Draft, C++ Extensions for Library Fundamentals, Version 2</a></li>
</ul></div>

      </div>
    </div>
  </div>
  
  
    <div id="sidebar" class="col-sm-3 col-sm-pull-9">
    </div>
  

</div>
            </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>
  </div>
</footer>
    </body>
</html>