316 lines
35 KiB
HTML
316 lines
35 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::ranges::copy, std::experimental::ranges::copy_if</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_ranges_algorithm_copy 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::ranges::</span>copy, <span style="font-size:0.7em; line-height:130%">std::experimental::ranges::</span>copy_if</h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-experimental.html">experimental</a>‎ | <a href="cpp-experimental-ranges.html">ranges</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-ranges-algorithm.html"><experimental/ranges/algorithm></a></code></div>
|
|
</td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-ranges">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span> <span class="sy1"><</span> <a href="cpp-experimental-ranges-iterator-InputIterator.html"><span class="kw2569">ranges::<span class="me2">InputIterator</span></span></a> I, <a href="cpp-experimental-ranges-iterator-Sentinel.html"><span class="kw2567">ranges::<span class="me2">Sentinel</span></span></a><span class="sy1"><</span>I<span class="sy1">></span> S,<br /></span>
|
|
<p> <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O <span class="sy1">></span><br />
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>I, O<span class="sy1">></span><br />
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>I<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span><br /></p>
|
|
copy<span class="br0">(</span>I first, S last, O result<span class="br0">)</span><span class="sy4">;</span></div>
|
|
</td>
|
|
<td>(1)</td>
|
|
<td><span class="t-mark-rev t-since-ranges-ts t-mark-ts">(范围 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-ranges">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span> <span class="sy1"><</span> <a href="cpp-experimental-ranges-range-InputRange.html"><span class="kw2592">ranges::<span class="me2">InputRange</span></span></a> Rng, <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O <span class="sy1">></span><br /></span>
|
|
<p> requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span>, O<span class="sy1">></span><br />
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span><br />
|
|
ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">safe_iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span><span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span><br /></p>
|
|
copy<span class="br0">(</span>Rng<span class="sy3">&&</span> rng, O result<span class="br0">)</span><span class="sy4">;</span></div>
|
|
</td>
|
|
<td>(2)</td>
|
|
<td><span class="t-mark-rev t-since-ranges-ts t-mark-ts">(范围 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-ranges">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span> <span class="sy1"><</span> <a href="cpp-experimental-ranges-iterator-InputIterator.html"><span class="kw2569">ranges::<span class="me2">InputIterator</span></span></a> I, <a href="cpp-experimental-ranges-iterator-Sentinel.html"><span class="kw2567">ranges::<span class="me2">Sentinel</span></span></a><span class="sy1"><</span>I<span class="sy1">></span> S,<br /></span>
|
|
<p> <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O,<br />
|
|
<span class="kw1">class</span> Proj <span class="sy1">=</span> ranges<span class="sy4">::</span><span class="me2">identity</span>,<br />
|
|
<a href="cpp-experimental-ranges-iterator-IndirectUnaryPredicate.html"><span class="kw2576">ranges::<span class="me2">IndirectUnaryPredicate</span></span></a><span class="sy1"><</span><a href="cpp-experimental-ranges-iterator-projected.html"><span class="kw2597">ranges::<span class="me2">projected</span></span></a><span class="sy1"><</span>I, Proj<span class="sy1">>></span> Pred <span class="sy1">></span><br />
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>I, O<span class="sy1">></span><br />
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>I<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span><br /></p>
|
|
copy_if<span class="br0">(</span>I first, S last, O result, Pred pred, Proj proj <span class="sy1">=</span> Proj<span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span></div>
|
|
</td>
|
|
<td>(3)</td>
|
|
<td><span class="t-mark-rev t-since-ranges-ts t-mark-ts">(范围 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl t-since-ranges">
|
|
<td>
|
|
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span> <span class="sy1"><</span> <a href="cpp-experimental-ranges-range-InputRange.html"><span class="kw2592">ranges::<span class="me2">InputRange</span></span></a> Rng, <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O,<br /></span>
|
|
<p> <span class="kw1">class</span> Proj <span class="sy1">=</span> ranges<span class="sy4">::</span><span class="me2">identity</span>,<br />
|
|
<a href="cpp-experimental-ranges-iterator-IndirectUnaryPredicate.html"><span class="kw2576">ranges::<span class="me2">IndirectUnaryPredicate</span></span></a><span class="sy1"><</span><br />
|
|
<a href="cpp-experimental-ranges-iterator-projected.html"><span class="kw2597">ranges::<span class="me2">projected</span></span></a><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span>, Proj<span class="sy1">>></span> Pred <span class="sy1">></span><br />
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>iterator_t<span class="sy1"><</span>Rng<span class="sy1">></span>, O<span class="sy1">></span><br />
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span><br />
|
|
ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">safe_iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span><span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span><br /></p>
|
|
copy_if<span class="br0">(</span>Rng<span class="sy3">&&</span> rng, O result, Pred pred, Proj proj <span class="sy1">=</span> Proj<span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span></div>
|
|
</td>
|
|
<td>(4)</td>
|
|
<td><span class="t-mark-rev t-since-ranges-ts t-mark-ts">(范围 TS)</span></td>
|
|
</tr>
|
|
<tr class="t-dcl-sep">
|
|
<td></td>
|
|
<td></td>
|
|
<td></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p>复制源范围( <code>[first,last)</code> 或 <code>rng</code> )中的元素到始于 <code>result</code> 的目标范围中,从源范围的首元素开始,后续到末元素。</p>
|
|
<div class="t-li1"><span class="t-li">1)</span> 复制范围 <code>[first, last)</code> 中的所有元素。对每个非负整数 <code>n < (last - first)</code> 进行 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="sy2">*</span><span class="br0">(</span>result <span class="sy2">+</span> n<span class="br0">)</span> <span class="sy1">=</span> <span class="sy2">*</span><span class="br0">(</span>first <span class="sy2">+</span> n<span class="br0">)</span></span></span> 。若 <code>result</code> 在范围 <code>[first, last)</code> 内则行为未定义。此情况下可用 <span class="t-lc">ranges::copy_backward</span> 代替。</div>
|
|
<div class="t-li1"><span class="t-li">2)</span> 同 <span class="t-v">(1)</span> ,但以 <code>rng</code> 为源范围,如同用 <span class="t-c"><span class="mw-geshi cpp source-cpp">ranges<span class="sy4">::</span><span class="me2">copy</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">begin</span><span class="br0">(</span>rng<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">end</span><span class="br0">(</span>rng<span class="br0">)</span>, result<span class="br0">)</span><span class="sy4">;</span></span></span> ,除了不可复制 <code>result</code> 。</div>
|
|
<div class="t-li1"><span class="t-li">3)</span> 仅复制应用谓词 <code>pred</code> 到投影 <code>proj</code> 所投影的元素值时,对其返回 <span class="t-c"><span class="mw-geshi cpp source-cpp"><span class="kw2">true</span></span></span> 的元素。保持复制后的元素顺序。若源与目标范围重叠则行为未定义。</div>
|
|
<div class="t-li1"><span class="t-li">4)</span> 同 <span class="t-v">(3)</span> ,但以 <code>rng</code> 为源范围,如同用 <span class="t-c"><span class="mw-geshi cpp source-cpp">ranges<span class="sy4">::</span><span class="me2">copy_if</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">begin</span><span class="br0">(</span>rng<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">end</span><span class="br0">(</span>rng<span class="br0">)</span>, result, pred, proj<span class="br0">)</span><span class="sy4">;</span></span></span> ,除了不可复制 <code>result</code> 、 <code>pred</code> 和 <code>proj</code> 。</div>
|
|
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">参数</span></h3>
|
|
<table class="t-par-begin">
|
|
<tr class="t-par">
|
|
<td>first, last</td>
|
|
<td>-</td>
|
|
<td>要复制的元素范围</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>rng</td>
|
|
<td>-</td>
|
|
<td>要复制的元素范围</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>result</td>
|
|
<td>-</td>
|
|
<td>目标范围的起始</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>pred</td>
|
|
<td>-</td>
|
|
<td>要应用到投影后元素的谓词</td>
|
|
</tr>
|
|
<tr class="t-par">
|
|
<td>proj</td>
|
|
<td>-</td>
|
|
<td>要应用到元素的投影</td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">返回值</span></h3>
|
|
<p>含有以下二个成员的 <code>tagged_pair</code> 对象:</p>
|
|
<ul>
|
|
<li>第一成员有标签 <code>tag::in</code> ,为源范围的尾后迭代器(即比较等于哨位 <code>last</code> 的 <code>I</code> 类型迭代器)。</li>
|
|
<li>第二成员有标签 <code>tag::out</code> ,为结果范围的尾后迭代器。</li>
|
|
</ul>
|
|
<h3><span class="mw-headline" id=".E5.A4.8D.E6.9D.82.E5.BA.A6">复杂度</span></h3>
|
|
<div class="t-li1"><span class="t-li">1)</span> 准确赋值 <span class="t-c"><span class="mw-geshi cpp source-cpp">ranges<span class="sy4">::</span><span class="me2">distance</span><span class="br0">(</span>first, last<span class="br0">)</span></span></span> 次。</div>
|
|
<div class="t-li1"><span class="t-li">2)</span> 准确赋值 <span class="t-c"><span class="mw-geshi cpp source-cpp">ranges<span class="sy4">::</span><span class="me2">distance</span><span class="br0">(</span>rng<span class="br0">)</span></span></span> 次。</div>
|
|
<div class="t-li1"><span class="t-li">3)</span> 准确应用 <span class="t-c"><span class="mw-geshi cpp source-cpp">ranges<span class="sy4">::</span><span class="me2">distance</span><span class="br0">(</span>first, last<span class="br0">)</span></span></span> 次对应的投影和谓词。</div>
|
|
<div class="t-li1"><span class="t-li">3)</span> 准确应用 <span class="t-c"><span class="mw-geshi cpp source-cpp">ranges<span class="sy4">::</span><span class="me2">distance</span><span class="br0">(</span>rng<span class="br0">)</span></span></span> 次对应的投影和谓词。</div>
|
|
<h3><span class="mw-headline" id=".E5.8F.AF.E8.83.BD.E7.9A.84.E5.AE.9E.E7.8E.B0">可能的实现</span></h3>
|
|
<table class="eq-fun-cpp-table">
|
|
<tr>
|
|
<th>版本一</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">template</span> <span class="sy1"><</span><a href="cpp-experimental-ranges-iterator-InputIterator.html"><span class="kw2569">ranges::<span class="me2">InputIterator</span></span></a> I, <a href="cpp-experimental-ranges-iterator-Sentinel.html"><span class="kw2567">ranges::<span class="me2">Sentinel</span></span></a><span class="sy1"><</span>I<span class="sy1">></span> S, <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O<span class="sy1">></span>
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>I, O<span class="sy1">></span><span class="br0">(</span><span class="br0">)</span>
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>I<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span>
|
|
copy<span class="br0">(</span>I first, S last, O result<span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="kw1">for</span> <span class="br0">(</span><span class="sy4">;</span> first <span class="sy3">!</span><span class="sy1">=</span> last<span class="sy4">;</span> <span class="sy2">++</span>first, <span class="br0">(</span><span class="kw4">void</span><span class="br0">)</span><span class="sy2">++</span>result<span class="br0">)</span>
|
|
<span class="sy2">*</span>result <span class="sy1">=</span> <span class="sy2">*</span>first<span class="sy4">;</span>
|
|
<span class="kw1">return</span> <span class="br0">{</span>first, result<span class="br0">}</span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<th>版本二</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">template</span> <span class="sy1"><</span><a href="cpp-experimental-ranges-range-InputRange.html"><span class="kw2592">ranges::<span class="me2">InputRange</span></span></a> Rng, <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O<span class="sy1">></span>
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span>, O<span class="sy1">></span><span class="br0">(</span><span class="br0">)</span>
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">safe_iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span><span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span>
|
|
copy<span class="br0">(</span>Rng<span class="sy3">&&</span> rng, O result<span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="kw1">return</span> ranges<span class="sy4">::</span><span class="me2">copy</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">begin</span><span class="br0">(</span>rng<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">end</span><span class="br0">(</span>rng<span class="br0">)</span>, result<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<th>版本三</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">template</span> <span class="sy1"><</span><a href="cpp-experimental-ranges-iterator-InputIterator.html"><span class="kw2569">ranges::<span class="me2">InputIterator</span></span></a> I, <a href="cpp-experimental-ranges-iterator-Sentinel.html"><span class="kw2567">ranges::<span class="me2">Sentinel</span></span></a><span class="sy1"><</span>I<span class="sy1">></span> S, <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O,
|
|
<span class="kw1">class</span> Proj <span class="sy1">=</span> ranges<span class="sy4">::</span><span class="me2">identity</span>,
|
|
<a href="cpp-experimental-ranges-iterator-IndirectUnaryPredicate.html"><span class="kw2576">ranges::<span class="me2">IndirectUnaryPredicate</span></span></a><span class="sy1"><</span><a href="cpp-experimental-ranges-iterator-projected.html"><span class="kw2597">ranges::<span class="me2">projected</span></span></a><span class="sy1"><</span>I, Proj<span class="sy1">>></span> Pred<span class="sy1">></span>
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>I, O<span class="sy1">></span><span class="br0">(</span><span class="br0">)</span>
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>I<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span>
|
|
copy_if<span class="br0">(</span>I first, S last, O result, Pred pred, Proj proj <span class="sy1">=</span> Proj<span class="br0">{</span><span class="br0">}</span><span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="kw1">for</span> <span class="br0">(</span><span class="sy4">;</span> first <span class="sy3">!</span><span class="sy1">=</span> last<span class="sy4">;</span> <span class="sy2">++</span>first<span class="br0">)</span> <span class="br0">{</span>
|
|
<span class="kw1">if</span> <span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">invoke</span><span class="br0">(</span>pred, ranges<span class="sy4">::</span><span class="me2">invoke</span><span class="br0">(</span>proj, <span class="sy2">*</span>first<span class="br0">)</span><span class="br0">)</span><span class="br0">)</span><span class="br0">{</span>
|
|
<span class="sy2">*</span>result <span class="sy1">=</span> <span class="sy2">*</span>first<span class="sy4">;</span>
|
|
<span class="sy2">++</span>result<span class="sy4">;</span>
|
|
<span class="br0">}</span>
|
|
<span class="br0">}</span>
|
|
<span class="kw1">return</span> <span class="br0">{</span>first, result<span class="br0">}</span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<th>版本四</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">template</span> <span class="sy1"><</span><a href="cpp-experimental-ranges-range-InputRange.html"><span class="kw2592">ranges::<span class="me2">InputRange</span></span></a> Rng, <a href="cpp-experimental-ranges-iterator-WeaklyIncrementable.html"><span class="kw2564">ranges::<span class="me2">WeaklyIncrementable</span></span></a> O,
|
|
<span class="kw1">class</span> Proj <span class="sy1">=</span> ranges<span class="sy4">::</span><span class="me2">identity</span>,
|
|
<a href="cpp-experimental-ranges-iterator-IndirectUnaryPredicate.html"><span class="kw2576">ranges::<span class="me2">IndirectUnaryPredicate</span></span></a><span class="sy1"><</span>
|
|
<a href="cpp-experimental-ranges-iterator-projected.html"><span class="kw2597">ranges::<span class="me2">projected</span></span></a><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span>, Proj<span class="sy1">>></span> Pred<span class="sy1">></span>
|
|
requires <a href="cpp-experimental-ranges-iterator-IndirectlyCopyable.html"><span class="kw2581">ranges::<span class="me2">IndirectlyCopyable</span></span></a><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span>, O<span class="sy1">></span><span class="br0">(</span><span class="br0">)</span>
|
|
ranges<span class="sy4">::</span><span class="me2">tagged_pair</span><span class="sy1"><</span>ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">in</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">safe_iterator_t</span><span class="sy1"><</span>Rng<span class="sy1">></span><span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">tag</span><span class="sy4">::</span><span class="me2">out</span><span class="br0">(</span>O<span class="br0">)</span><span class="sy1">></span>
|
|
copy_if<span class="br0">(</span>Rng<span class="sy3">&&</span> rng, O result, Pred pred, Proj proj <span class="sy1">=</span> Proj<span class="br0">{</span><span class="br0">}</span><span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="kw1">return</span> ranges<span class="sy4">::</span><span class="me2">copy_if</span><span class="br0">(</span>ranges<span class="sy4">::</span><span class="me2">begin</span><span class="br0">(</span>rng<span class="br0">)</span>, ranges<span class="sy4">::</span><span class="me2">end</span><span class="br0">(</span>rng<span class="br0">)</span>, result, pred, proj<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">示例</span></h3>
|
|
<div class="t-example">
|
|
<p>下列代码用 copy 复制一个 <code>vector</code> 的内容给另一个,并显示结果 <code>vector</code> :</p>
|
|
<div class="t-example-live-link"></div>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="co2">#include <experimental/ranges/algorithm></span>
|
|
<span class="co2">#include <iostream></span>
|
|
<span class="co2">#include <vector></span>
|
|
<span class="co2">#include <experimental/ranges/iterator></span>
|
|
<span class="co2">#include <numeric></span>
|
|
|
|
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span>
|
|
<span class="br0">{</span>
|
|
<span class="co1">// 参阅 http://zh.cppreference.com/w/cpp/language/namespace_alias</span>
|
|
<span class="kw1">namespace</span> ranges <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">experimental</span><span class="sy4">::</span><span class="me2">ranges</span><span class="sy4">;</span>
|
|
|
|
<a href="cpp-container-vector.html"><span class="kw1269">std::<span class="me2">vector</span></span></a><span class="sy1"><</span><span class="kw4">int</span><span class="sy1">></span> from_vector<span class="br0">(</span><span class="nu0">10</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<a href="cpp-algorithm-iota.html"><span class="kw1655">std::<span class="me2">iota</span></span></a><span class="br0">(</span>from_vector.<span class="me1">begin</span><span class="br0">(</span><span class="br0">)</span>, from_vector.<span class="me1">end</span><span class="br0">(</span><span class="br0">)</span>, <span class="nu0">0</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<a href="cpp-container-vector.html"><span class="kw1269">std::<span class="me2">vector</span></span></a><span class="sy1"><</span><span class="kw4">int</span><span class="sy1">></span> to_vector<span class="sy4">;</span>
|
|
ranges<span class="sy4">::</span><span class="me2">copy_if</span><span class="br0">(</span>from_vector.<span class="me1">begin</span><span class="br0">(</span><span class="br0">)</span>, from_vector.<span class="me1">end</span><span class="br0">(</span><span class="br0">)</span>,
|
|
ranges<span class="sy4">::</span><span class="me2">back_inserter</span><span class="br0">(</span>to_vector<span class="br0">)</span>,
|
|
<span class="br0">[</span><span class="br0">]</span><span class="br0">(</span><span class="kw4">const</span> <span class="kw4">auto</span> i<span class="br0">)</span> <span class="br0">{</span>
|
|
<span class="kw1">return</span> i <span class="sy2">%</span> <span class="nu0">3</span><span class="sy4">;</span>
|
|
<span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="co1">// 或替用的</span>
|
|
<span class="co1">// std::vector<int> to_vector(from_vector.size());</span>
|
|
<span class="co1">// std::copy(from_vector, to_vector.begin());</span>
|
|
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">"to_vector contains: "</span><span class="sy4">;</span>
|
|
|
|
ranges<span class="sy4">::</span><span class="me2">copy</span><span class="br0">(</span>to_vector, ranges<span class="sy4">::</span><span class="me2">ostream_iterator</span><span class="sy1"><</span><span class="kw4">int</span><span class="sy1">></span><span class="br0">(</span><a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a>, <span class="st0">" "</span><span class="br0">)</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<a href="cpp-io-cout.html"><span class="kw1758">std::<span class="me2">cout</span></span></a> <span class="sy1"><<</span> <span class="st0">'<span class="es1">\n</span>'</span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
<p>输出:</p>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="text source-text">
|
|
<pre class="de1">to_vector contains: 1 2 4 5 7 8</pre></div>
|
|
</div>
|
|
</div>
|
|
<h3><span class="mw-headline" id=".E5.8F.82.E9.98.85">参阅</span></h3>
|
|
<table class="t-dsc-begin">
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-algorithm-copy.html"><span class="t-lines"><span>copy</span><span>copy_if</span></span></a></div>
|
|
<div><span class="t-lines"><span></span><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>将某一范围的元素复制到一个新的位置<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/experimental/ranges/algorithm/copy_backward&action=edit&redlink=1" class="new" title="cpp/experimental/ranges/algorithm/copy backward(页面不存在)"><span class="t-lines"><span>copy_backward</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>按从后往前的顺序复制一个范围内的元素<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/experimental/ranges/algorithm/reverse_copy&action=edit&redlink=1" class="new" title="cpp/experimental/ranges/algorithm/reverse copy(页面不存在)"><span class="t-lines"><span>reverse_copy</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>创建一个范围的逆向副本<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/experimental/ranges/algorithm/copy_n&action=edit&redlink=1" class="new" title="cpp/experimental/ranges/algorithm/copy n(页面不存在)"><span class="t-lines"><span>copy_n</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>将一定数目的元素复制到一个新的位置<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/experimental/ranges/algorithm/fill&action=edit&redlink=1" class="new" title="cpp/experimental/ranges/algorithm/fill(页面不存在)"><span class="t-lines"><span>fill</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>将一个特定值赋值给一个元素范围<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="https://zh.cppreference.com/mwiki/index.php?title=cpp/experimental/ranges/algorithm/remove_copy&action=edit&redlink=1" class="new" title="cpp/experimental/ranges/algorithm/remove copy(页面不存在)"><span class="t-lines"><span>remove_copy</span><span>remove_copy_if</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>复制元素范围,忽略满足特定判别标准的元素<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|