395 lines
40 KiB
HTML
395 lines
40 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>标准库头文件 <tuple></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_header_tuple 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%">标准库头文件</span> <tuple></h1>
|
|
<div id="bodyContent">
|
|
<div id="contentSub"><span class="subpages">< <a href="cpp.html">cpp</a>‎ | <a href="cpp-header.html">header</a></span></div>
|
|
<div id="mw-content-text" lang="zh" dir="ltr" class="mw-content-ltr" xml:lang="zh">
|
|
<p>此头文件是<a href="cpp-utility.html">通用工具</a>库的一部分。</p>
|
|
<table class="t-dsc-begin">
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.8C.85.E5.90.AB">包含</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-header-compare.html"><span class="t-lines"><span><compare></span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td><a href="cpp-language-operator_comparison.html#.E4.B8.89.E8.B7.AF.E6.AF.94.E8.BE.83">三路比较运算符</a>支持</td>
|
|
</tr>
|
|
</table>
|
|
<table class="t-dsc-begin">
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E7.B1.BB">类</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple.html"><span class="t-lines"><span>tuple</span></span></a></div>
|
|
<div><span class="t-lines"><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="cpp-utility-tuple_size.html"><span class="t-lines"><span>tuple_size</span></span></a></div>
|
|
<div><span class="t-lines"><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="cpp-utility-tuple_element.html"><span class="t-lines"><span>tuple_element</span></span></a></div>
|
|
<div><span class="t-lines"><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="cpp-utility-tuple-tuple_size.html"><span class="t-lines"><span>std::tuple_size<span class="t-dsc-small"><std::tuple></span></span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>在编译时获得 <code>tuple</code> 的大小<br />
|
|
<span class="t-mark">(类模板特化)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-tuple_element.html"><span class="t-lines"><span>std::tuple_element<span class="t-dsc-small"><std::tuple></span></span></span></a></div>
|
|
<div><span class="t-lines"><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="cpp-utility-tuple-uses_allocator.html"><span class="t-lines"><span>std::uses_allocator<span class="t-dsc-small"><std::tuple></span></span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>特化 <span class="t-lc"><a href="cpp-memory-uses_allocator.html">std::uses_allocator</a></span> 类型特征<br />
|
|
<span class="t-mark">(类模板特化)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.B8.B8.E9.87.8F">常量</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-ignore.html"><span class="t-lines"><span>ignore</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>用 <a href="cpp-utility-tuple-tie.html"><tt>tie</tt></a> 解包 <code>tuple</code> 时用来跳过元素的占位符<br />
|
|
<span class="t-mark">(常量)</span></td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2">
|
|
<h3><span class="mw-headline" id=".E5.87.BD.E6.95.B0">函数</span></h3>
|
|
</td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-make_tuple.html"><span class="t-lines"><span>make_tuple</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>创建一个 <code>tuple</code> 对象，其类型根据各实参类型定义<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-tie.html"><span class="t-lines"><span>tie</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>创建左值引用的 <code>tuple</code>，或将 tuple 解包为独立对象<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-forward_as_tuple.html"><span class="t-lines"><span>forward_as_tuple</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>创建<a href="cpp-language-reference.html#.E8.BD.AC.E5.8F.91.E5.BC.95.E7.94.A8">转发引用</a>的 <code>tuple</code><br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-tuple_cat.html"><span class="t-lines"><span>tuple_cat</span></span></a></div>
|
|
</div>
|
|
</td>
|
|
<td>通过连接任意数量的元组来创建一个<code>tuple</code><br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-get.html"><span class="t-lines"><span>std::get<span class="t-dsc-small">(std::tuple)</span></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="cpp-utility-tuple-operator_cmp.html"><span class="t-lines"><span>operator==</span><span>operator!=</span><span>operator<</span><span>operator<=</span><span>operator></span><span>operator>=</span><span>operator<=></span></span></a></div>
|
|
<div><span class="t-lines"><span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-until-cxx20">(C++20 中移除)</span></span><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>按字典顺序比较 tuple 中的值<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-tuple-swap2.html"><span class="t-lines"><span>std::swap<span class="t-dsc-small">(std::tuple)</span></span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx11">(C++11)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>特化 <span class="t-lc"><a href="cpp-algorithm-swap.html">std::swap</a></span> 算法<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
<tr class="t-dsc">
|
|
<td>
|
|
<div class="t-dsc-member-div">
|
|
<div><a href="cpp-utility-apply.html"><span class="t-lines"><span>apply</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</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="cpp-utility-make_from_tuple.html"><span class="t-lines"><span>make_from_tuple</span></span></a></div>
|
|
<div><span class="t-lines"><span><span class="t-mark-rev t-since-cxx17">(C++17)</span></span></span></div>
|
|
</div>
|
|
</td>
|
|
<td>以一个实参元组构造对象<br />
|
|
<span class="t-mark">(函数模板)</span></td>
|
|
</tr>
|
|
</table>
|
|
<h3><span class="mw-headline" id=".E6.A6.82.E8.A6.81">概要</span></h3>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="co2">#include <compare></span>
|
|
|
|
<span class="kw1">namespace</span> std <span class="br0">{</span>
|
|
<span class="co1">// 类模板 tuple</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw1">class</span> tuple<span class="sy4">;</span>
|
|
|
|
<span class="co1">// tuple 创建函数</span>
|
|
<span class="kw1">inline</span> <span class="kw4">constexpr</span> <span class="coMULTI">/* 未指定 */</span> ignore<span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">TTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy1"><</span>unwrap_ref_decay_t<span class="sy1"><</span>TTypes<span class="sy1">></span>...<span class="sy1">></span> make_tuple<span class="br0">(</span>TTypes<span class="sy3">&&</span>...<span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">TTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy1"><</span>TTypes<span class="sy3">&&</span>...<span class="sy1">></span> forward_as_tuple<span class="br0">(</span>TTypes<span class="sy3">&&</span>...<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">TTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy1"><</span>TTypes<span class="sy3">&</span>...<span class="sy1">></span> tie<span class="br0">(</span>TTypes<span class="sy3">&</span>...<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">Tuples</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy1"><</span>CTypes...<span class="sy1">></span> tuple_cat<span class="br0">(</span>Tuples<span class="sy3">&&</span>...<span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 以参数的 tuple 调用函数</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> F, <span class="kw1">class</span> Tuple<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> decltype<span class="br0">(</span><span class="kw4">auto</span><span class="br0">)</span> apply<span class="br0">(</span>F<span class="sy3">&&</span> f, Tuple<span class="sy3">&&</span> t<span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T, <span class="kw1">class</span> Tuple<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> T make_from_tuple<span class="br0">(</span>Tuple<span class="sy3">&&</span> t<span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// tuple 辅助类</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">struct</span> tuple_size<span class="sy4">;</span> <span class="co1">// 不定义</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">struct</span> tuple_size<span class="sy1"><</span><span class="kw4">const</span> T<span class="sy1">></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span> <span class="kw1">struct</span> tuple_size<span class="sy1"><</span>tuple<span class="sy1"><</span>Types...<span class="sy1">>></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">struct</span> tuple_element<span class="sy4">;</span> <span class="co1">// 不定义</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">struct</span> tuple_element<span class="sy1"><</span>I, <span class="kw4">const</span> T<span class="sy1">></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw1">struct</span> tuple_element<span class="sy1"><</span>I, tuple<span class="sy1"><</span>Types...<span class="sy1">>></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span> T<span class="sy1">></span>
|
|
<span class="kw1">using</span> tuple_element_t <span class="sy1">=</span> <span class="kw1">typename</span> tuple_element<span class="sy1"><</span>I, T<span class="sy1">></span><span class="sy4">::</span><span class="me2">type</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 元素访问</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple_element_t<span class="sy1"><</span>I, tuple<span class="sy1"><</span>Types...<span class="sy1">>></span><span class="sy3">&</span> get<span class="br0">(</span>tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple_element_t<span class="sy1"><</span>I, tuple<span class="sy1"><</span>Types...<span class="sy1">>></span><span class="sy3">&&</span> get<span class="br0">(</span>tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">const</span> tuple_element_t<span class="sy1"><</span>I, tuple<span class="sy1"><</span>Types...<span class="sy1">>></span><span class="sy3">&</span>
|
|
get<span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">const</span> tuple_element_t<span class="sy1"><</span>I, tuple<span class="sy1"><</span>Types...<span class="sy1">>></span><span class="sy3">&&</span>
|
|
get<span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> T<span class="sy3">&</span> get<span class="br0">(</span>tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&</span> t<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> T<span class="sy3">&&</span> get<span class="br0">(</span>tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&&</span> t<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">const</span> T<span class="sy3">&</span> get<span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&</span> t<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T, <span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">const</span> T<span class="sy3">&&</span> get<span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&&</span> t<span class="br0">)</span> <span class="kw1">noexcept</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 关系运算符</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">TTypes</span>, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">bool</span> operator<span class="sy1">==</span><span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>TTypes...<span class="sy1">></span><span class="sy3">&</span>, <span class="kw4">const</span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">TTypes</span>, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> common_comparison_category_t<span class="sy1"><</span><span class="coMULTI">/*synth-three-way-result*/</span><span class="sy1"><</span>TTypes, UTypes<span class="sy1">></span>...<span class="sy1">></span>
|
|
operator<span class="sy1"><=></span><span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>TTypes...<span class="sy1">></span><span class="sy3">&</span>, <span class="kw4">const</span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 分配器相关特征</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">Types</span>, <span class="kw1">class</span> Alloc<span class="sy1">></span>
|
|
<span class="kw1">struct</span> uses_allocator<span class="sy1"><</span>tuple<span class="sy1"><</span>Types...<span class="sy1">></span>, Alloc<span class="sy1">></span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// 特化的算法</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">void</span>
|
|
swap<span class="br0">(</span>tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&</span> x, tuple<span class="sy1"><</span>Types...<span class="sy1">></span><span class="sy3">&</span> y<span class="br0">)</span> <span class="kw1">noexcept</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// tuple 辅助类</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span>
|
|
<span class="kw1">inline</span> <span class="kw4">constexpr</span> size_t tuple_size_v <span class="sy1">=</span> tuple_size<span class="sy1"><</span>T<span class="sy1">></span><span class="sy4">::</span><span class="me2">value</span><span class="sy4">;</span>
|
|
<span class="br0">}</span>
|
|
|
|
<span class="co1">// 弃用</span>
|
|
<span class="kw1">namespace</span> std <span class="br0">{</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">class</span> tuple_size<span class="sy1"><</span><span class="kw4">volatile</span> T<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">class</span> tuple_size<span class="sy1"><</span><span class="kw4">const</span> <span class="kw4">volatile</span> T<span class="sy1">></span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">class</span> tuple_element<span class="sy1"><</span>I, <span class="kw4">volatile</span> T<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span>size_t I, <span class="kw1">class</span> T<span class="sy1">></span> <span class="kw1">class</span> tuple_element<span class="sy1"><</span>I, <span class="kw4">const</span> <span class="kw4">volatile</span> T<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
<h4><span class="mw-headline" id=".E7.B1.BB.E6.A8.A1.E6.9D.BF_std::tuple">类模板 <span class="t-lc"><a href="cpp-utility-tuple.html">std::tuple</a></span></span></h4>
|
|
<div dir="ltr" class="mw-geshi" style="text-align: left;">
|
|
<div class="cpp source-cpp">
|
|
<pre class="de1"><span class="kw1">namespace</span> std <span class="br0">{</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">Types</span><span class="sy1">></span>
|
|
<span class="kw1">class</span> tuple <span class="br0">{</span>
|
|
<span class="kw1">public</span><span class="sy4">:</span>
|
|
<span class="co1">// tuple 创建</span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span> tuple<span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span><span class="kw4">const</span> Types<span class="sy3">&</span>...<span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 仅若 sizeof...(Types) >= 1</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>UTypes<span class="sy3">&&</span>...<span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 仅若 sizeof...(Types) >= 1</span>
|
|
|
|
tuple<span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy3">&</span><span class="br0">)</span> <span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span>
|
|
tuple<span class="br0">(</span>tuple<span class="sy3">&&</span><span class="br0">)</span> <span class="sy1">=</span> <span class="kw1">default</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span> tuple<span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span> tuple<span class="br0">(</span>tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> U1, <span class="kw1">class</span> U2<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span><span class="kw4">const</span> pair<span class="sy1"><</span>U1, U2<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 仅若 sizeof...(Types) == 2</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> U1, <span class="kw1">class</span> U2<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>pair<span class="sy1"><</span>U1, U2<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 仅若 sizeof...(Types) == 2</span>
|
|
|
|
<span class="co1">// allocator-extended constructors</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, <span class="kw4">const</span> Types<span class="sy3">&</span>...<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, UTypes<span class="sy3">&&</span>...<span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, <span class="kw4">const</span> tuple<span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, tuple<span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, <span class="kw4">const</span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span> U1, <span class="kw1">class</span> U2<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, <span class="kw4">const</span> pair<span class="sy1"><</span>U1, U2<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span> U1, <span class="kw1">class</span> U2<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> <span class="kw1">explicit</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, <span class="kw4">const</span> Alloc<span class="sy3">&</span> a, pair<span class="sy1"><</span>U1, U2<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="co1">// tuple 赋值</span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span>tuple<span class="sy3">&&</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span><span class="kw4">const</span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span>tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> U1, <span class="kw1">class</span> U2<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span><span class="kw4">const</span> pair<span class="sy1"><</span>U1, U2<span class="sy1">></span><span class="sy3">&</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 仅若 sizeof...(Types) == 2</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> U1, <span class="kw1">class</span> U2<span class="sy1">></span>
|
|
<span class="kw4">constexpr</span> tuple<span class="sy3">&</span> operator<span class="sy1">=</span><span class="br0">(</span>pair<span class="sy1"><</span>U1, U2<span class="sy1">></span><span class="sy3">&&</span><span class="br0">)</span><span class="sy4">;</span> <span class="co1">// 仅若 sizeof...(Types) == 2</span>
|
|
|
|
<span class="co1">// tuple 交换</span>
|
|
<span class="kw4">constexpr</span> <span class="kw4">void</span> swap<span class="br0">(</span>tuple<span class="sy3">&</span><span class="br0">)</span> <span class="kw1">noexcept</span><span class="br0">(</span><span class="coMULTI">/* 见描述 */</span><span class="br0">)</span><span class="sy4">;</span>
|
|
<span class="br0">}</span><span class="sy4">;</span>
|
|
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
tuple<span class="br0">(</span>UTypes...<span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> T1, <span class="kw1">class</span> T2<span class="sy1">></span>
|
|
tuple<span class="br0">(</span>pair<span class="sy1"><</span>T1, T2<span class="sy1">></span><span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> tuple<span class="sy1"><</span>T1, T2<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, Alloc, UTypes...<span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span> T1, <span class="kw1">class</span> T2<span class="sy1">></span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, Alloc, pair<span class="sy1"><</span>T1, T2<span class="sy1">></span><span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> tuple<span class="sy1"><</span>T1, T2<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="kw1">template</span><span class="sy1"><</span><span class="kw1">class</span> Alloc, <span class="kw1">class</span>... <span class="me1">UTypes</span><span class="sy1">></span>
|
|
tuple<span class="br0">(</span>allocator_arg_t, Alloc, tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="br0">)</span> <span class="sy2">-</span><span class="sy1">></span> tuple<span class="sy1"><</span>UTypes...<span class="sy1">></span><span class="sy4">;</span>
|
|
<span class="br0">}</span></pre></div>
|
|
</div>
|
|
</div>
|
|
<div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html>
|