上传cppreference

This commit is contained in:
2025-08-01 12:57:54 +08:00
parent e29892f8cd
commit 196e706fe4
5485 changed files with 982007 additions and 3 deletions

View File

@@ -0,0 +1,251 @@
<!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::integer_sequence</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_utility_integer_sequence 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::</span>integer_sequence</h1>
<div id="bodyContent">
<div id="contentSub"><span class="subpages">&lt; <a href="cpp.html">cpp</a>&lrm; | <a href="cpp-utility.html">utility</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>&#23450;&#20041;&#20110;&#22836;&#25991;&#20214; <code><a href="cpp-header-utility.html">&lt;utility&gt;</a></code></div>
</td>
<td></td>
<td></td>
</tr>
<tr class="t-dcl t-since-cxx14">
<td>
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1">&lt;</span> <span class="kw1">class</span> T, T... <span class="me1">Ints</span> <span class="sy1">&gt;</span><br />
<span class="kw1">struct</span> integer_sequence<span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td><span class="t-mark-rev t-since-cxx14">(C++14 &#36215;)</span></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>&#31867;&#27169;&#26495; <code>std::integer_sequence</code> &#34920;&#31034;&#19968;&#20010;&#32534;&#35793;&#26102;&#30340;&#25972;&#25968;&#24207;&#21015;&#12290;&#22312;&#29992;&#20316;<a href="cpp-language-function_template.html">&#20989;&#25968;&#27169;&#26495;</a>&#30340;&#23454;&#21442;&#26102;&#65292;&#33021;&#25512;&#23548;<a href="cpp-language-parameter_pack.html">&#21442;&#25968;&#21253;</a> <code>Ints</code> &#24182;&#23558;&#23427;&#29992;&#20110;&#21253;&#23637;&#24320;&#12290;</p>
<h3><span class="mw-headline" id=".E6.A8.A1.E6.9D.BF.E5.BD.A2.E5.8F.82">&#27169;&#26495;&#24418;&#21442;</span></h3>
<table class="t-par-begin">
<tr class="t-par">
<td>T</td>
<td>-</td>
<td>&#29992;&#20110;&#24207;&#21015;&#20803;&#32032;&#30340;&#25972;&#25968;&#31867;&#22411;</td>
</tr>
<tr class="t-par">
<td>...Ints</td>
<td>-</td>
<td>&#34920;&#31034;&#24207;&#21015;&#30340;&#38750;&#31867;&#22411;&#24418;&#21442;&#21253;</td>
</tr>
</table>
<h3><span class="mw-headline" id=".E6.88.90.E5.91.98.E7.B1.BB.E5.9E.8B">&#25104;&#21592;&#31867;&#22411;</span></h3>
<table class="t-dsc-begin">
<tr class="t-dsc-hitem">
<td>&#25104;&#21592;&#31867;&#22411;</td>
<td>&#23450;&#20041;</td>
</tr>
<tr class="t-dsc">
<td><code>value_type</code></td>
<td><code>T</code></td>
</tr>
</table>
<h3><span class="mw-headline" id=".E6.88.90.E5.91.98.E5.87.BD.E6.95.B0">&#25104;&#21592;&#20989;&#25968;</span></h3>
<table class="t-dsc-begin">
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><strong class="selflink"><span class="t-lines"><span>size</span></span></strong></div>
<div><span class="t-lines"><span><span class="t-cmark">[&#38745;&#24577;]</span></span></span></div>
</div>
</td>
<td>&#36820;&#22238; <code>Ints</code> &#20013;&#30340;&#20803;&#32032;&#25968;<br />
<span class="t-mark">(&#20844;&#24320;&#38745;&#24577;&#25104;&#21592;&#20989;&#25968;)</span></td>
</tr>
</table>
<div class="t-member">
<h2><span class="mw-headline" id="std::integer_sequence::size"><span style="font-size:0.7em; line-height:130%">std::integer_sequence::</span>size</span></h2>
<table class="t-dcl-begin">
<tbody>
<tr class="t-dcl">
<td class="t-dcl-nopad">
<div><span class="mw-geshi cpp source-cpp"><span class="kw4">static</span> <span class="kw4">constexpr</span> <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> size<span class="br0">(</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>&#36820;&#22238; <code>Ints</code> &#20013;&#30340;&#20803;&#32032;&#25968;&#12290;&#31561;&#20215;&#20110; <span class="t-c"><span class="mw-geshi cpp source-cpp">sizeof...<span class="br0">(</span>Ints<span class="br0">)</span></span></span> &#12290;</p>
<h3><span class="mw-headline" id=".E5.8F.82.E6.95.B0">&#21442;&#25968;</span></h3>
<p>&#65288;&#26080;&#65289;</p>
<h3><span class="mw-headline" id=".E8.BF.94.E5.9B.9E.E5.80.BC">&#36820;&#22238;&#20540;</span></h3>
<p><code>Ints</code> &#20013;&#30340;&#20803;&#32032;&#25968;&#12290;</p>
</div>
<h3><span class="mw-headline" id=".E8.BE.85.E5.8A.A9.E6.A8.A1.E6.9D.BF">&#36741;&#21161;&#27169;&#26495;</span></h3>
<p>&#20026;&#24110;&#21161; <code>T</code> &#20026; <span class="t-lc"><a href="cpp-types-size_t.html">std::size_t</a></span> &#30340;&#24120;&#29992;&#24773;&#20917;&#65292;&#23450;&#20041;&#36741;&#21161;&#21035;&#21517;&#27169;&#26495; <code><b>std::index_sequence</b></code> &#12290;</p>
<table class="t-dcl-begin">
<tbody>
<tr class="t-dcl">
<td class="t-dcl-nopad">
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1">&lt;</span><a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a>... <span class="me1">Ints</span><span class="sy1">&gt;</span><br />
<span class="kw1">using</span> index_sequence <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">integer_sequence</span><span class="sy1">&lt;</span><a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a>, Ints...<span class="sy1">&gt;</span><span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>&#20998;&#21035;&#23450;&#20041;&#36741;&#21161;&#21035;&#21517;&#27169;&#26495; <code><b>std::make_integer_sequence</b></code> &#19982; <code><b>std::make_index_sequence</b></code> &#20197;&#31616;&#21270;&#20197; 0, 1, 2, ..., <code>N-1</code> &#20026; <code>Ints</code> &#21019;&#24314; <code>std::integer_sequence</code> &#19982; <code>std::index_sequence</code> &#31867;&#22411;&#65306;</p>
<table class="t-dcl-begin">
<tbody>
<tr class="t-dcl">
<td class="t-dcl-nopad">
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, T N<span class="sy1">&gt;</span><br />
<span class="kw1">using</span> make_integer_sequence <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">integer_sequence</span><span class="sy1">&lt;</span>T, <span class="coMULTI">/* a sequence 0, 1, 2, ..., N-1 */</span> <span class="sy1">&gt;</span><span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl">
<td class="t-dcl-nopad">
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1">&lt;</span><a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> N<span class="sy1">&gt;</span><br />
<span class="kw1">using</span> make_index_sequence <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">make_integer_sequence</span><span class="sy1">&lt;</span><a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a>, N<span class="sy1">&gt;</span><span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>&#33509; <code>N</code> &#20026;&#36127;&#21017;&#31243;&#24207;&#20026;&#35884;&#26500;&#12290;&#33509; <code>N</code> &#20026;&#38646;&#65292;&#21017;&#25351;&#31034;&#31867;&#22411;&#20026; <code>integer_sequence&lt;T&gt;</code> &#12290;</p>
<p>&#23450;&#20041;&#36741;&#21161;&#31867;&#27169;&#26495; <code><b>std::index_sequence_for</b></code> &#65292;&#20197;&#36716;&#25442;&#20219;&#20309;&#31867;&#22411;&#21442;&#25968;&#21253;&#20026;&#21516;&#38271;&#24230;&#30340;&#19979;&#26631;&#24207;&#21015;&#65306;</p>
<table class="t-dcl-begin">
<tbody>
<tr class="t-dcl">
<td class="t-dcl-nopad">
<div><span class="mw-geshi cpp source-cpp"><span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span>... <span class="me1">T</span><span class="sy1">&gt;</span><br />
<span class="kw1">using</span> index_sequence_for <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">make_index_sequence</span><span class="sy1">&lt;</span>sizeof...<span class="br0">(</span>T<span class="br0">)</span><span class="sy1">&gt;</span><span class="sy4">;</span></span></div>
</td>
<td class="t-dcl-nopad"></td>
<td class="t-dcl-nopad"></td>
</tr>
<tr class="t-dcl-sep">
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<h3><span class="mw-headline" id=".E7.A4.BA.E4.BE.8B">&#31034;&#20363;</span></h3>
<div class="t-example">
<p>&#27880;&#24847;&#65306;&#21478;&#19968;&#31034;&#20363;&#35265; <a href="cpp-utility-apply.html#.E5.8F.AF.E8.83.BD.E7.9A.84.E5.AE.9E.E7.8E.B0"><code>std::apply</code> &#20013;&#21487;&#33021;&#30340;&#23454;&#29616;</a>&#12290;</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 &lt;tuple&gt;</span>
<span class="co2">#include &lt;iostream&gt;</span>
<span class="co2">#include &lt;array&gt;</span>
<span class="co2">#include &lt;utility&gt;</span>
<span class="co1">// &#35843;&#35797;&#36741;&#21161;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">typename</span> T, T... <span class="me1">ints</span><span class="sy1">&gt;</span>
<span class="kw4">void</span> print_sequence<span class="br0">(</span>std<span class="sy4">::</span><span class="me2">integer_sequence</span><span class="sy1">&lt;</span>T, ints...<span class="sy1">&gt;</span> int_seq<span class="br0">)</span>
<span class="br0">{</span>
<a href="cpp-io-cout.html"><span class="kw1753">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> <span class="st0">&quot;The sequence of size &quot;</span> <span class="sy1">&lt;&lt;</span> int_seq.<span class="me1">size</span><span class="br0">(</span><span class="br0">)</span> <span class="sy1">&lt;&lt;</span> <span class="st0">&quot;: &quot;</span><span class="sy4">;</span>
<span class="br0">(</span><span class="br0">(</span><a href="cpp-io-cout.html"><span class="kw1753">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> ints <span class="sy1">&lt;&lt;</span> <span class="st0">&#39; &#39;</span><span class="br0">)</span>,...<span class="br0">)</span><span class="sy4">;</span>
<a href="cpp-io-cout.html"><span class="kw1753">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> <span class="st0">&#39;<span class="es1">\n</span>&#39;</span><span class="sy4">;</span>
<span class="br0">}</span>
<span class="co1">// &#36716;&#25442;&#25968;&#32452;&#20026; tuple</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">typename</span> Array, <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a>... <span class="me1">I</span><span class="sy1">&gt;</span>
<span class="kw4">auto</span> a2t_impl<span class="br0">(</span><span class="kw4">const</span> Array<span class="sy3">&amp;</span> a, std<span class="sy4">::</span><span class="me2">index_sequence</span><span class="sy1">&lt;</span>I...<span class="sy1">&gt;</span><span class="br0">)</span>
<span class="br0">{</span>
<span class="kw1">return</span> <a href="cpp-utility-tuple-make_tuple.html"><span class="kw1107">std::<span class="me2">make_tuple</span></span></a><span class="br0">(</span>a<span class="br0">[</span>I<span class="br0">]</span>...<span class="br0">)</span><span class="sy4">;</span>
<span class="br0">}</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">typename</span> T, <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a> N, <span class="kw1">typename</span> Indices <span class="sy1">=</span> std<span class="sy4">::</span><span class="me2">make_index_sequence</span><span class="sy1">&lt;</span>N<span class="sy1">&gt;&gt;</span>
<span class="kw4">auto</span> a2t<span class="br0">(</span><span class="kw4">const</span> <a href="cpp-container-array.html"><span class="kw1263">std::<span class="me2">array</span></span></a><span class="sy1">&lt;</span>T, N<span class="sy1">&gt;</span><span class="sy3">&amp;</span> a<span class="br0">)</span>
<span class="br0">{</span>
<span class="kw1">return</span> a2t_impl<span class="br0">(</span>a, Indices<span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
<span class="br0">}</span>
<span class="co1">// &#28418;&#20142;&#22320;&#25171;&#21360; tuple</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Ch, <span class="kw1">class</span> Tr, <span class="kw1">class</span> Tuple, <a href="cpp-types-size_t.html"><span class="kw100">std::<span class="me2">size_t</span></span></a>... <span class="me1">Is</span><span class="sy1">&gt;</span>
<span class="kw4">void</span> print_tuple_impl<span class="br0">(</span><a href="cpp-io-basic_ostream.html"><span class="kw1710">std::<span class="me2">basic_ostream</span></span></a><span class="sy1">&lt;</span>Ch,Tr<span class="sy1">&gt;</span><span class="sy3">&amp;</span> os,
<span class="kw4">const</span> Tuple<span class="sy3">&amp;</span> t,
std<span class="sy4">::</span><span class="me2">index_sequence</span><span class="sy1">&lt;</span>Is...<span class="sy1">&gt;</span><span class="br0">)</span>
<span class="br0">{</span>
<span class="br0">(</span><span class="br0">(</span>os <span class="sy1">&lt;&lt;</span> <span class="br0">(</span>Is <span class="sy1">==</span> <span class="nu0">0</span><span class="sy4">?</span> <span class="st0">&quot;&quot;</span> <span class="sy4">:</span> <span class="st0">&quot;, &quot;</span><span class="br0">)</span> <span class="sy1">&lt;&lt;</span> std<span class="sy4">::</span><span class="me2">get</span><span class="sy1">&lt;</span>Is<span class="sy1">&gt;</span><span class="br0">(</span>t<span class="br0">)</span><span class="br0">)</span>, ...<span class="br0">)</span><span class="sy4">;</span>
<span class="br0">}</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Ch, <span class="kw1">class</span> Tr, <span class="kw1">class</span>... <span class="me1">Args</span><span class="sy1">&gt;</span>
<span class="kw4">auto</span><span class="sy3">&amp;</span> operator<span class="sy1">&lt;&lt;</span><span class="br0">(</span><a href="cpp-io-basic_ostream.html"><span class="kw1710">std::<span class="me2">basic_ostream</span></span></a><span class="sy1">&lt;</span>Ch, Tr<span class="sy1">&gt;</span><span class="sy3">&amp;</span> os, <span class="kw4">const</span> <a href="cpp-utility-tuple.html"><span class="kw1098">std::<span class="me2">tuple</span></span></a><span class="sy1">&lt;</span>Args...<span class="sy1">&gt;</span><span class="sy3">&amp;</span> t<span class="br0">)</span>
<span class="br0">{</span>
os <span class="sy1">&lt;&lt;</span> <span class="st0">&quot;(&quot;</span><span class="sy4">;</span>
print_tuple_impl<span class="br0">(</span>os, t, std<span class="sy4">::</span><span class="me2">index_sequence_for</span><span class="sy1">&lt;</span>Args...<span class="sy1">&gt;</span><span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">return</span> os <span class="sy1">&lt;&lt;</span> <span class="st0">&quot;)&quot;</span><span class="sy4">;</span>
<span class="br0">}</span>
<span class="kw4">int</span> main<span class="br0">(</span><span class="br0">)</span>
<span class="br0">{</span>
print_sequence<span class="br0">(</span>std<span class="sy4">::</span><span class="me2">integer_sequence</span><span class="sy1">&lt;</span><span class="kw4">unsigned</span>, <span class="nu0">9</span>, <span class="nu0">2</span>, <span class="nu0">5</span>, <span class="nu0">1</span>, <span class="nu0">9</span>, <span class="nu0">1</span>, <span class="nu0">6</span><span class="sy1">&gt;</span><span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
print_sequence<span class="br0">(</span>std<span class="sy4">::</span><span class="me2">make_integer_sequence</span><span class="sy1">&lt;</span><span class="kw4">int</span>, <span class="nu0">20</span><span class="sy1">&gt;</span><span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
print_sequence<span class="br0">(</span>std<span class="sy4">::</span><span class="me2">make_index_sequence</span><span class="sy1">&lt;</span><span class="nu0">10</span><span class="sy1">&gt;</span><span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
print_sequence<span class="br0">(</span>std<span class="sy4">::</span><span class="me2">index_sequence_for</span><span class="sy1">&lt;</span><span class="kw4">float</span>, <a href="cpp-io-basic_iostream.html"><span class="kw1726">std::<span class="me2">iostream</span></span></a>, <span class="kw4">char</span><span class="sy1">&gt;</span><span class="br0">{</span><span class="br0">}</span><span class="br0">)</span><span class="sy4">;</span>
<a href="cpp-container-array.html"><span class="kw1263">std::<span class="me2">array</span></span></a><span class="sy1">&lt;</span><span class="kw4">int</span>, <span class="nu0">4</span><span class="sy1">&gt;</span> array <span class="sy1">=</span> <span class="br0">{</span><span class="nu0">1</span>,<span class="nu0">2</span>,<span class="nu0">3</span>,<span class="nu0">4</span><span class="br0">}</span><span class="sy4">;</span>
<span class="co1">// &#36716;&#25442; array &#20026; tuple</span>
<span class="kw4">auto</span> tuple <span class="sy1">=</span> a2t<span class="br0">(</span>array<span class="br0">)</span><span class="sy4">;</span>
static_assert<span class="br0">(</span><a href="cpp-types-is_same.html"><span class="kw588">std::<span class="me2">is_same</span></span></a><span class="sy1">&lt;</span>decltype<span class="br0">(</span>tuple<span class="br0">)</span>,
<a href="cpp-utility-tuple.html"><span class="kw1098">std::<span class="me2">tuple</span></span></a><span class="sy1">&lt;</span><span class="kw4">int</span>, <span class="kw4">int</span>, <span class="kw4">int</span>, <span class="kw4">int</span><span class="sy1">&gt;&gt;</span><span class="sy4">::</span><span class="me2">value</span>, <span class="st0">&quot;&quot;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="co1">// &#25171;&#21360;&#21040; cout</span>
<a href="cpp-io-cout.html"><span class="kw1753">std::<span class="me2">cout</span></span></a> <span class="sy1">&lt;&lt;</span> tuple <span class="sy1">&lt;&lt;</span> <span class="st0">&#39;<span class="es1">\n</span>&#39;</span><span class="sy4">;</span>
<span class="br0">}</span></pre></div>
</div>
<p>&#36755;&#20986;&#65306;</p>
<div dir="ltr" class="mw-geshi" style="text-align: left;">
<div class="text source-text">
<pre class="de1">The sequence of size 7: 9 2 5 1 9 1 6
The sequence of size 20: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
The sequence of size 10: 0 1 2 3 4 5 6 7 8 9
The sequence of size 3: 0 1 2
(1, 2, 3, 4)</pre></div>
</div>
</div>
</div>
<div class="visualClear"></div>
</div>
</div>
</div>
</body>
</html>