251 lines
19 KiB
HTML
251 lines
19 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="zh" dir="ltr" class="client-nojs" xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh">
|
|
<head><meta http-equiv="x-ua-compatible" content="ie=edge">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>std::experimental::pmr::resource_adaptor</title>
|
|
<link rel="stylesheet" href="ext.css" />
|
|
<link rel="stylesheet" href="site_modules.css" />
|
|
</head>
|
|
<body class="mediawiki ltr sitedir-ltr ns-0 ns-subject page-cpp_experimental_resource_adaptor skin-cppreference2 action-view cpp-navbar">
|
|
<div id="cpp-content-base">
|
|
<div id="content"><a id="top"></a>
|
|
<h1 id="firstHeading" class="firstHeading"><span style="font-size:0.7em; line-height:130%">std::experimental::pmr::</span>resource_adaptor</h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-experimental.html">experimental</a></span></div>
|
|
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dsc-header">
|
|
<td>
|
|
<div>定义于头文件 <code><a href="cpp-header-experimental-memory_resource.html"><experimental/memory_resource></a></code></div>
|
|
</td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span> <span class="kw1">class</span> Alloc <span class="sy1">></span><br /></span>
|
|
<p><span class="kw1">using</span> resource_adaptor <span class="sy1">=</span> <span class="coMULTI">/*resource-adaptor-imp*/</span><span class="sy1"><</span><br />
|
|
<span class="kw1">typename</span> <a href="cpp-memory-allocator_traits.html"><span class="kw701">std::<span class="me2">allocator_traits</span></span></a><span class="sy1"><</span>Allocator<span class="sy1">></span><span class="sy4">::</span><br /></p>
|
|
<span class="kw1">template</span> rebind_alloc<span class="sy1"><</span><span class="kw4">char</span><span class="sy1">>></span><span class="sy4">;</span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1"><</span> <span class="kw1">class</span> Alloc <span class="sy1">></span><br />
|
|
<span class="kw1">class</span> <span class="coMULTI">/*resource-adaptor-imp*/</span> <span class="sy4">:</span> <span class="kw1">public</span> memory_resource<span class="sy4">;</span> <span class="co1">// 仅用于阐释</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>别名模版 <code>resource_adaptor</code> 将分配器类型 <code>Allocator</code> 与 <code>memory_resource</code> 接口适配。在实际适配前（用 <i><code>resource-adaptor-imp</code></i> 类模板）将分配器重绑定到 <code>char</code> 类型，故适配同一分配器的模板特化总是生成同一类型，无关乎分配器模板原先实例化所用的值类型。</p>
|
|
<p><i><code>resource-adaptor-imp</code></i> 是类模板，成员描述如下。名称 <i><code>resource-adaptor-imp</code></i> 仅为阐释用途，而非强制规定。</p>
|
|
<p>除了符合<a href="cpp-named_req-Allocator.html"><span style="font-style:italic">分配器</span> <span style="font-family: Georgia, 'DejaVu Serif', serif; font-style:italic">(Allocator)</span></a> 要求， <code>Alloc</code> 还必须额外满足下列要求：</p>
|
|
<ul>
|
|
<li><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-memory-allocator_traits.html"><span class="kw701">std::<span class="me2">allocator_traits</span></span></a><span class="sy1"><</span>Alloc<span class="sy1">></span><span class="sy4">::</span><span class="me2">pointer</span></span></span> 应当等同于 <span class="t-c"><span class="mw-geshi cpp source-cpp">Alloc<span class="sy4">::</span><span class="me2">value_type</span><span class="sy2">*</span></span></span> 。</li>
|
|
<li><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-memory-allocator_traits.html"><span class="kw701">std::<span class="me2">allocator_traits</span></span></a><span class="sy1"><</span>Alloc<span class="sy1">></span><span class="sy4">::</span><span class="me2">const_pointer</span></span></span> 应当等同于 <span class="t-c"><span class="mw-geshi cpp source-cpp">Alloc<span class="sy4">::</span><span class="me2">value_type</span> <span class="kw4">const</span><span class="sy2">*</span></span></span> 。</li>
|
|
<li><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-memory-allocator_traits.html"><span class="kw701">std::<span class="me2">allocator_traits</span></span></a><span class="sy1"><</span>Alloc<span class="sy1">></span><span class="sy4">::</span><span class="me2">void_pointer</span></span></span> 应当等同于 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">void</span><span class="sy2">*</span></span></span> 。</li>
|
|
<li><span class="t-c"><span class="mw-geshi cpp source-cpp"><a href="cpp-memory-allocator_traits.html"><span class="kw701">std::<span class="me2">allocator_traits</span></span></a><span class="sy1"><</span>Alloc<span class="sy1">></span><span class="sy4">::</span><span class="me2">const_const_pointer</span></span></span> 应当等同于 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw4">void</span> <span class="kw4">const</span><span class="sy2">*</span></span></span> 。</li>
|
|
</ul>
|
|
<p>本页面中的类型 <code>memory_resorce</code> 在 LFTS v1 与 v2 中代表 <span class="t-lc"><a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/experimental/memory_resource&action=edit&redlink=1" class="new" title="cpp/experimental/memory resource（页面不存在）">std::experimental::pmr::memory_resource</a></span> ，但从 LFTS v3 起代表 <span class="t-lc"><a href="cpp-memory-memory_resource.html">std::pmr::memory_resource</a></span> 。</p>
|
|
<h3><span class="mw-headline" id="resource-adaptor-imp_.E7.9A.84.E6.88.90.E5.91.98.E7.B1.BB.E5.9E.8B"><i>resource-adaptor-imp</i> 的成员类型</span></h3>
|
|
<table class="t-dsc-begin">
|
|
<tr class="t-dsc-hitem">
|
|
<td>成员类型</td>
|
|
<td>定义</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td><code>allocator_type</code></td>
|
|
<td><code>Alloc</code></td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id="resource-adaptor-imp_.E7.9A.84.E6.88.90.E5.91.98.E5.87.BD.E6.95.B0"><i>resource-adaptor-imp</i> 的成员函数</span></h3>
|
|
<div class="t-member">
|
|
<h2><span style="font-size:0.7em; line-height:130%"><i>resource-adaptor-imp</i>::</span><i>resource-adaptor-imp</i></h2>
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="coMULTI">/*resource-adaptor-imp*/</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td>(1)</td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="coMULTI">/*resource-adaptor-imp*/</span><span class="br0">(</span><span class="kw4">const</span> <span class="coMULTI">/*resource-adaptor-imp*/</span><span class="sy3">&</span> other<span class="br0">)</span><br />
|
|
<span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td>(2)</td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="coMULTI">/*resource-adaptor-imp*/</span><span class="br0">(</span><span class="coMULTI">/*resource-adaptor-imp*/</span><span class="sy3">&&</span> other<span class="br0">)</span><br />
|
|
<span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td>(3)</td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">explicit</span> <span class="coMULTI">/*resource-adaptor-imp*/</span><span class="br0">(</span><span class="kw4">const</span> Alloc<span class="sy3">&</span> a2<span class="br0">)</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td>(4)</td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">explicit</span> <span class="coMULTI">/*resource-adaptor-imp*/</span><span class="br0">(</span>Alloc<span class="sy3">&&</span> a2<span class="br0">)</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td>(5)</td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<div class="t-li1"><span class="t-li">1)</span> 默认构造函数。默认构造被包装分配器。</div>
|
|
<div class="t-li1"><span class="t-li">2)</span> 复制构造函数。从 <code>other</code> 所包装的分配器复制构造被包装分配器。</div>
|
|
<div class="t-li1"><span class="t-li">3)</span> 移动构造函数。从 <code>other</code> 所包装的分配器移动构造被包装分配器。</div>
|
|
<div class="t-li1"><span class="t-li">4)</span> 以 <code>a2</code> 初始化被包装分配器。</div>
|
|
<div class="t-li1"><span class="t-li">5)</span> 以 <span class="t-c"><span class="mw-geshi cpp source-cpp">std<span class="sy4">::</span><span class="me2">move</span><span class="br0">(</span>a2<span class="br0">)</span></span></span> 初始化被包装分配器。</div>
|
|
<h4><span class="mw-headline" id=".E5.8F.82.E6.95.B0">参数</span></h4>
|
|
<table class="t-par-begin">
|
|
<tr class="t-par">
|
|
<td>other</td>
|
|
<td>-</td>
|
|
<td>复制或移动来源的另一 <i><code>resource-adaptor-imp</code></i> 对象</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>a2</td>
|
|
<td>-</td>
|
|
<td>复制或移动来源的另一 <code>Alloc</code> 对象</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="t-member">
|
|
<h2><span style="font-size:0.7em; line-height:130%"><i>resource-adaptor-imp</i>::</span>get_allocator</h2>
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp">allocator_type get_allocator<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>返回被包装分配器的副本。</p>
|
|
</div>
|
|
<div class="t-member">
|
|
<h2><span style="font-size:0.7em; line-height:130%"><i>resource-adaptor-imp</i>::</span>operator=</h2>
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="coMULTI">/*resource-adaptor-imp*/</span><span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span><span class="kw4">const</span> <span class="coMULTI">/*resource-adaptor-imp*/</span><span class="sy3">&</span> other<span class="br0">)</span><br />
|
|
<span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>默认化的复制赋值运算符。从 <code>other</code> 的被包装分配器复制赋值被包装分配器。</p>
|
|
</div>
|
|
<div class="t-member">
|
|
<h2><span style="font-size:0.7em; line-height:130%"><i>resource-adaptor-imp</i>::</span>do_allocate</h2>
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">protected</span><span class="sy4">:</span><br />
|
|
<span class="kw1">virtual</span> <span class="kw4">void</span><span class="sy2">*</span> do_allocate<span class="br0">(</span><a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> bytes, <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> alignment<span class="br0">)</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>用被包装分配器的 <code>allocate</code> 成员函数分配内存。</p>
|
|
</div>
|
|
<div class="t-member">
|
|
<h2><span style="font-size:0.7em; line-height:130%"><i>resource-adaptor-imp</i>::</span>do_deallocate</h2>
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">protected</span><span class="sy4">:</span><br />
|
|
<span class="kw1">virtual</span> <span class="kw4">void</span> do_deallocate<span class="br0">(</span><span class="kw4">void</span> <span class="sy2">*</span>p, <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> bytes, <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> alignment<span class="br0">)</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>用被包装分配器的 <code>deallocate</code> 成员函数解分配 <code>p</code> 所指向的存储。</p>
|
|
<p><code>p</code> 必须已经用比较等于被包装分配器的分配器的 <code>allocate</code> 成员函数分配，而且之后必须未被解分配。</p>
|
|
</div>
|
|
<div class="t-member">
|
|
<h2><span style="font-size:0.7em; line-height:130%"><i>resource-adaptor-imp</i>::</span>do_is_equal</h2>
|
|
<table class="t-dcl-begin">
|
|
<tbody>
|
|
<tr class="t-dcl t-since-libfund_ts">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">protected</span><span class="sy4">:</span><br />
|
|
<span class="kw1">virtual</span> <span class="kw4">bool</span> do_is_equal<span class="br0">(</span><span class="kw4">const</span> memory_resource<span class="sy3">&</span> other<span class="br0">)</span> <span class="kw4">const</span> <span class="kw1">noexcept</span><span class="sy4">;</span></span></div>
|
|
</td>
|
|
<td class="t-dcl-nopad"></td>
|
|
<td><span class="t-mark-rev t-since-libfund-ts t-mark-ts">(库基础 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>令 <code>p</code> 为 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw1">dynamic_cast</span><span class="sy1"><</span><span class="kw4">const</span> <span class="coMULTI">/*resource-adaptor-imp*/</span><span class="sy2">*</span><span class="sy1">></span><span class="br0">(</span><span class="sy3">&</span>other<span class="br0">)</span></span></span> 。若 <code>p</code> 为空指针值则返回 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw2">false</span></span></span> 。否则返回用 <span class="t-c"><span class="mw-geshi cpp source-cpp">operator<span class="sy1">==</span></span></span> 比较 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="sy2">*</span>p</span></span> 和 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="sy2">*</span>this</span></span> 所包装的分配器的结果。</p>
|
|
</div>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|