klarkxy/hustoj
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

上传cppreference

Browse Source
This commit is contained in:
klarkxy
2025-08-01 12:57:54 +08:00
parent e29892f8cd
commit 196e706fe4
5485 changed files with 982007 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

191
web/cppreference-zh/chmhelp/cpp-header-stack.html Normal file
View File

@@ -0,0 +1,191 @@
<!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>&#26631;&#20934;&#24211;&#22836;&#25991;&#20214; &lt;stack&gt;</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_stack 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%">&#26631;&#20934;&#24211;&#22836;&#25991;&#20214;</span> &lt;stack&gt;</h1>
<div id="bodyContent">
<div id="contentSub"><span class="subpages">&lt; <a href="cpp.html">cpp</a>&lrm; | <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>&#27492;&#22836;&#25991;&#20214;&#26159;<a href="cpp-container.html">&#23481;&#22120;</a>&#24211;&#30340;&#19968;&#37096;&#20998;&#12290;</p>
<table class="t-dsc-begin">
<tr>
<td colspan="2">
<h3><span class="mw-headline" id=".E5.8C.85.E5.90.AB">&#21253;&#21547;</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>&lt;compare&gt;</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">&#19977;&#36335;&#27604;&#36739;&#36816;&#31639;&#31526;</a>&#25903;&#25345;</td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-header-initializer_list.html"><span class="t-lines"><span>&lt;initializer_list&gt;</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-utility-initializer_list.html">std::initializer_list</a></span> &#31867;&#27169;&#26495;</td>
</tr>
<tr>
<td colspan="2">
<h3><span class="mw-headline" id=".E7.B1.BB">&#31867;</span></h3>
</td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-container-stack.html"><span class="t-lines"><span>stack</span></span></a></div>
</div>
</td>
<td>&#36866;&#37197;&#19968;&#20010;&#23481;&#22120;&#20197;&#25552;&#20379;&#26632;&#65288;LIFO &#25968;&#25454;&#32467;&#26500;&#65289;<br />
<span class="t-mark">(&#31867;&#27169;&#26495;)</span></td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-container-stack-uses_allocator.html"><span class="t-lines"><span>std::uses_allocator<span class="t-dsc-small">&lt;std::stack&gt;</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>&#29305;&#21270; <span class="t-lc"><a href="cpp-memory-uses_allocator.html">std::uses_allocator</a></span> &#31867;&#22411;&#29305;&#24449;<br />
<span class="t-mark">(&#31867;&#27169;&#26495;&#29305;&#21270;)</span></td>
</tr>
<tr>
<td colspan="2">
<h3><span class="mw-headline" id=".E5.87.BD.E6.95.B0">&#20989;&#25968;</span></h3>
</td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-container-stack-operator_cmp.html"><span class="t-lines"><span>operator==</span><span>operator!=</span><span>operator&lt;</span><span>operator&lt;=</span><span>operator&gt;</span><span>operator&gt;=</span><span>operator&lt;=&gt;</span></span></a></div>
<div><span class="t-lines"><span></span><span></span><span></span><span></span><span></span><span></span><span><span class="t-mark-rev t-since-cxx20">(C++20)</span></span></span></div>
</div>
</td>
<td>&#25353;&#29031;&#23383;&#20856;&#39034;&#24207;&#27604;&#36739; stack &#20013;&#30340;&#20540;<br />
<span class="t-mark">(&#20989;&#25968;&#27169;&#26495;)</span></td>
</tr>
<tr class="t-dsc">
<td>
<div class="t-dsc-member-div">
<div><a href="cpp-container-stack-swap2.html"><span class="t-lines"><span>std::swap<span class="t-dsc-small">(std::stack)</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>&#29305;&#21270; <span class="t-lc"><a href="cpp-algorithm-swap.html">std::swap</a></span> &#31639;&#27861;<br />
<span class="t-mark">(&#20989;&#25968;&#27169;&#26495;)</span></td>
</tr>
</table>
<h3><span class="mw-headline" id=".E6.A6.82.E8.A6.81">&#27010;&#35201;</span></h3>
<div dir="ltr" class="mw-geshi" style="text-align: left;">
<div class="cpp source-cpp">
<pre class="de1"><span class="co2">#include &lt;compare&gt;</span>
<span class="co2">#include &lt;initializer_list&gt;</span>
<span class="kw1">namespace</span> std <span class="br0">{</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container <span class="sy1">=</span> deque<span class="sy1">&lt;</span>T<span class="sy1">&gt;&gt;</span> <span class="kw1">class</span> stack<span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">bool</span> operator<span class="sy1">==</span><span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">bool</span> operator<span class="sy3">!</span><span class="sy1">=</span><span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">bool</span> operator<span class="sy1">&lt;</span> <span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">bool</span> operator<span class="sy1">&gt;</span> <span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">bool</span> operator<span class="sy1">&lt;=</span><span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">bool</span> operator<span class="sy1">&gt;=</span><span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, three_way_comparable Container<span class="sy1">&gt;</span>
compare_three_way_result_t<span class="sy1">&lt;</span>Container<span class="sy1">&gt;</span>
operator<span class="sy1">&lt;=&gt;</span><span class="br0">(</span><span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, <span class="kw4">const</span> stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container<span class="sy1">&gt;</span>
<span class="kw4">void</span> swap<span class="br0">(</span>stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> x, stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span><span class="sy3">&amp;</span> y<span class="br0">)</span>
<span class="kw1">noexcept</span><span class="br0">(</span><span class="kw1">noexcept</span><span class="br0">(</span>x.<span class="me1">swap</span><span class="br0">(</span>y<span class="br0">)</span><span class="br0">)</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container, <span class="kw1">class</span> Alloc<span class="sy1">&gt;</span>
<span class="kw1">struct</span> uses_allocator<span class="sy1">&lt;</span>stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span>, Alloc<span class="sy1">&gt;</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::stack">&#31867;&#27169;&#26495; <span class="t-lc"><a href="cpp-container-stack.html">std::stack</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">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container <span class="sy1">=</span> deque<span class="sy1">&lt;</span>T<span class="sy1">&gt;&gt;</span>
<span class="kw1">class</span> stack <span class="br0">{</span>
<span class="kw1">public</span><span class="sy4">:</span>
<span class="kw1">using</span> value_type <span class="sy1">=</span> <span class="kw1">typename</span> Container<span class="sy4">::</span><span class="me2">value_type</span><span class="sy4">;</span>
<span class="kw1">using</span> reference <span class="sy1">=</span> <span class="kw1">typename</span> Container<span class="sy4">::</span><span class="me2">reference</span><span class="sy4">;</span>
<span class="kw1">using</span> const_reference <span class="sy1">=</span> <span class="kw1">typename</span> Container<span class="sy4">::</span><span class="me2">const_reference</span><span class="sy4">;</span>
<span class="kw1">using</span> size_type <span class="sy1">=</span> <span class="kw1">typename</span> Container<span class="sy4">::</span><span class="me2">size_type</span><span class="sy4">;</span>
<span class="kw1">using</span> container_type <span class="sy1">=</span> Container<span class="sy4">;</span>
<span class="kw1">protected</span><span class="sy4">:</span>
Container c<span class="sy4">;</span>
<span class="kw1">public</span><span class="sy4">:</span>
stack<span class="br0">(</span><span class="br0">)</span> <span class="sy4">:</span> stack<span class="br0">(</span>Container<span class="br0">(</span><span class="br0">)</span><span class="br0">)</span> <span class="br0">{</span><span class="br0">}</span>
<span class="kw1">explicit</span> stack<span class="br0">(</span><span class="kw4">const</span> Container<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">explicit</span> stack<span class="br0">(</span>Container<span class="sy3">&amp;&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> InputIt<span class="sy1">&gt;</span> stack<span class="br0">(</span>InputIt first, InputIt last<span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Alloc<span class="sy1">&gt;</span> <span class="kw1">explicit</span> stack<span class="br0">(</span><span class="kw4">const</span> Alloc<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Alloc<span class="sy1">&gt;</span> stack<span class="br0">(</span><span class="kw4">const</span> Container<span class="sy3">&amp;</span>, <span class="kw4">const</span> Alloc<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Alloc<span class="sy1">&gt;</span> stack<span class="br0">(</span>Container<span class="sy3">&amp;&amp;</span>, <span class="kw4">const</span> Alloc<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Alloc<span class="sy1">&gt;</span> stack<span class="br0">(</span><span class="kw4">const</span> stack<span class="sy3">&amp;</span>, <span class="kw4">const</span> Alloc<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Alloc<span class="sy1">&gt;</span> stack<span class="br0">(</span>stack<span class="sy3">&amp;&amp;</span>, <span class="kw4">const</span> Alloc<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> InputIt, <span class="kw1">class</span> Alloc<span class="sy1">&gt;</span>
stack<span class="br0">(</span>InputIt first, InputIt last, <span class="kw4">const</span> Alloc<span class="sy3">&amp;</span><span class="br0">)</span><span class="sy4">;</span>
<span class="br0">[</span><span class="br0">[</span>nodiscard<span class="br0">]</span><span class="br0">]</span> <span class="kw4">bool</span> empty<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="br0">{</span> <span class="kw1">return</span> c.<span class="me1">empty</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
size_type size<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="br0">{</span> <span class="kw1">return</span> c.<span class="me1">size</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
reference top<span class="br0">(</span><span class="br0">)</span> <span class="br0">{</span> <span class="kw1">return</span> c.<span class="me1">back</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
const_reference top<span class="br0">(</span><span class="br0">)</span> <span class="kw4">const</span> <span class="br0">{</span> <span class="kw1">return</span> c.<span class="me1">back</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
<span class="kw4">void</span> push<span class="br0">(</span><span class="kw4">const</span> value_type<span class="sy3">&amp;</span> x<span class="br0">)</span> <span class="br0">{</span> c.<span class="me1">push_back</span><span class="br0">(</span>x<span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
<span class="kw4">void</span> push<span class="br0">(</span>value_type<span class="sy3">&amp;&amp;</span> x<span class="br0">)</span> <span class="br0">{</span> c.<span class="me1">push_back</span><span class="br0">(</span>std<span class="sy4">::</span><span class="me2">move</span><span class="br0">(</span>x<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>... <span class="me1">Args</span><span class="sy1">&gt;</span>
decltype<span class="br0">(</span><span class="kw4">auto</span><span class="br0">)</span> emplace<span class="br0">(</span>Args<span class="sy3">&amp;&amp;</span>... <span class="me1">args</span><span class="br0">)</span>
<span class="br0">{</span> <span class="kw1">return</span> c.<span class="me1">emplace_back</span><span class="br0">(</span><a href="cpp-utility-forward.html"><span class="kw1117">std::<span class="me2">forward</span></span></a><span class="sy1">&lt;</span>Args<span class="sy1">&gt;</span><span class="br0">(</span>args<span class="br0">)</span>...<span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
<span class="kw4">void</span> pop<span class="br0">(</span><span class="br0">)</span> <span class="br0">{</span> c.<span class="me1">pop_back</span><span class="br0">(</span><span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
<span class="kw4">void</span> swap<span class="br0">(</span>stack<span class="sy3">&amp;</span> s<span class="br0">)</span> <span class="kw1">noexcept</span><span class="br0">(</span>is_nothrow_swappable_v<span class="sy1">&lt;</span>Container<span class="sy1">&gt;</span><span class="br0">)</span>
<span class="br0">{</span> <span class="kw1">using</span> <a href="cpp-algorithm-swap.html"><span class="kw1599">std::<span class="me2">swap</span></span></a><span class="sy4">;</span> swap<span class="br0">(</span>c, s.<span class="me1">c</span><span class="br0">)</span><span class="sy4">;</span> <span class="br0">}</span>
<span class="br0">}</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Container<span class="sy1">&gt;</span>
stack<span class="br0">(</span>Container<span class="br0">)</span> <span class="sy2">-</span><span class="sy1">&gt;</span> stack<span class="sy1">&lt;</span><span class="kw1">typename</span> Container<span class="sy4">::</span><span class="me2">value_type</span>, Container<span class="sy1">&gt;</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> InputIt<span class="sy1">&gt;</span>
stack<span class="br0">(</span>InputIt, InputIt<span class="br0">)</span> <span class="sy2">-</span><span class="sy1">&gt;</span> stack<span class="sy1">&lt;</span><span class="coMULTI">/*iter-value-type*/</span><span class="sy1">&lt;</span>InputIt<span class="sy1">&gt;&gt;</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> Container, <span class="kw1">class</span> Allocator<span class="sy1">&gt;</span>
stack<span class="br0">(</span>Container, Allocator<span class="br0">)</span> <span class="sy2">-</span><span class="sy1">&gt;</span> stack<span class="sy1">&lt;</span><span class="kw1">typename</span> Container<span class="sy4">::</span><span class="me2">value_type</span>, Container<span class="sy1">&gt;</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> InputIt, <span class="kw1">class</span> Allocator<span class="sy1">&gt;</span>
stack<span class="br0">(</span>InputIt, InputIt, Allocator<span class="br0">)</span>
<span class="sy2">-</span><span class="sy1">&gt;</span> stack<span class="sy1">&lt;</span><span class="coMULTI">/*iter-value-type*/</span><span class="sy1">&lt;</span>InputIt<span class="sy1">&gt;</span>, deque<span class="sy1">&lt;</span><span class="coMULTI">/*iter-value-type*/</span><span class="sy1">&lt;</span>InputIt<span class="sy1">&gt;</span>,
Allocator<span class="sy1">&gt;&gt;</span><span class="sy4">;</span>
<span class="kw1">template</span><span class="sy1">&lt;</span><span class="kw1">class</span> T, <span class="kw1">class</span> Container, <span class="kw1">class</span> Alloc<span class="sy1">&gt;</span>
<span class="kw1">struct</span> uses_allocator<span class="sy1">&lt;</span>stack<span class="sy1">&lt;</span>T, Container<span class="sy1">&gt;</span>, Alloc<span class="sy1">&gt;</span>
<span class="sy4">:</span> uses_allocator<span class="sy1">&lt;</span>Container, Alloc<span class="sy1">&gt;</span><span class="sy4">::</span><span class="me2">type</span> <span class="br0">{</span> <span class="br0">}</span><span class="sy4">;</span>
<span class="br0">}</span></pre></div>
</div>
</div>
<div class="visualClear"></div>
</div>
</div>
</div>
</body>
</html>